Spotifymcp

🚀 Spotify-Claude MCP Server

这是一款连接 Spotify API 并使用 Claude 作为 AI 助手的工具，旨在增强音乐发现和互动体验。它能让用户通过自然语言查询与 Spotify 账户进行交互，为音乐爱好者带来更智能、便捷的音乐探索之旅。

🚀 快速开始

本项目通过模型控制协议（MCP）服务器将 Claude AI 与 Spotify API 集成。用户可以使用 Claude 处理后的自然语言查询与自己的 Spotify 账户进行交互。

✨ 主要特性

目前，Claude 可以利用 Spotify API 获取艺术家信息。后续还可扩展到其他查询功能，例如获取热门曲目、音乐流派、创建播放列表或获取用户个人资料数据等。

📦 安装指南

前提条件

• Spotify 开发者账户
• Spotify API 凭证（客户端 ID 和客户端密钥）
• Claude 桌面版

安装步骤

1. 克隆仓库：

git clone https://github.com/DivyamAgg24/SpotifyMCP.git
cd SpotifyMCP

2. 安装依赖项：

npm install

3. 设置环境变量： 在根目录下创建一个 .env 文件，并设置以下变量：

SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_ACCESS_TOKEN=access_token_obtained_from_clientId_and_clientSecret

📚 详细文档

配置

• 在 Spotify 开发者控制台注册你的应用。
• 在 Spotify 应用设置中添加 http://localhost:8888/callback 作为重定向 URI。
• 将客户端 ID 和客户端密钥复制到你的 .env 文件中。

使用方法

1. 构建项目：

tsc -b

2. 在 Claude 配置文件中添加 MCP 服务器配置。
3. 向 Claude 询问艺术家的名称。

工具功能

MCP 服务器向 Claude 公开了以下函数：

• get_artist(name)：检索艺术家的相关信息。

示例交互

用户："这位艺术家叫什么名字？"
Claude：[使用 get_artist 函数] "这位艺术家是 Pitbull。"

系统组件说明

• MCP 服务器：处理 Claude 和 Spotify API 之间的通信。
• Spotify API 客户端：管理对 Spotify 的身份验证和 API 请求。
• Claude 集成：处理自然语言并确定要调用的函数。