🚀 Spotify-Claude MCP Server
这是一款连接 Spotify API 并使用 Claude 作为 AI 助手的工具，旨在增强音乐发现和互动体验。它能让用户通过自然语言查询与 Spotify 账户进行交互，为音乐爱好者带来更智能、便捷的音乐探索之旅。
🚀 快速开始
本项目通过模型控制协议（MCP）服务器将 Claude AI 与 Spotify API 集成。用户可以使用 Claude 处理后的自然语言查询与自己的 Spotify 账户进行交互。
✨ 主要特性
目前，Claude 可以利用 Spotify API 获取艺术家信息。后续还可扩展到其他查询功能，例如获取热门曲目、音乐流派、创建播放列表或获取用户个人资料数据等。
📦 安装指南
前提条件
- Spotify 开发者账户
- Spotify API 凭证（客户端 ID 和客户端密钥）
- Claude 桌面版
安装步骤
- 克隆仓库：
git clone https://github.com/DivyamAgg24/SpotifyMCP.git
cd SpotifyMCP
- 安装依赖项：
npm install
- 设置环境变量：
在根目录下创建一个
.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文件中。
使用方法
- 构建项目：
tsc -b
- 在 Claude 配置文件中添加 MCP 服务器配置。
- 向 Claude 询问艺术家的名称。
工具功能
MCP 服务器向 Claude 公开了以下函数：
get_artist(name)：检索艺术家的相关信息。
示例交互
用户："这位艺术家叫什么名字？"
Claude：[使用 get_artist 函数] "这位艺术家是 Pitbull。"
系统组件说明
- MCP 服务器：处理 Claude 和 Spotify API 之间的通信。
- Spotify API 客户端：管理对 Spotify 的身份验证和 API 请求。
- Claude 集成：处理自然语言并确定要调用的函数。