Spotify MCP 服务器

该项目实现了一个模型上下文协议 (MCP)服务器，允许您通过 MCP 客户端（例如Cursor或Claude for Desktop （仅限 macOS 和 Windows））使用自然语言控制 Spotify 播放。

特征

该服务器公开以下工具：

• play ：播放曲目、专辑或播放列表，或者继续播放。
• pause ：暂停播放。
• next ：跳至下一曲目。
• previous ：跳至上一曲目。
• get_current_track ：获取有关当前播放曲目的信息。
• search ：搜索曲目、专辑、艺术家或播放列表。

先决条件

• Bun （1.0.0 或更高版本）
• Spotify Premium 帐户。
• Spotify 开发者应用程序：
  • 在Spotify 开发者仪表板上创建一个。
  • 获取您的客户端 ID 和客户端密钥。
  • 将http://localhost:8888/callback添加到应用程序设置中的重定向 URI。
• MCP 客户端（例如 Cursor 或 Claude for Desktop）。

安装和设置

1. 克隆存储库：
   git clone https://github.com/obre10off/spotify-mcp.git cd spotify-mcp
2. 安装依赖项：
   bun install
3. 创建.env文件：在项目根目录下创建一个名为.env的文件。添加以下内容，将占位符替换为你实际的 Spotify 凭据：
   SPOTIFY_CLIENT_ID=your_spotify_client_id SPOTIFY_CLIENT_SECRET=your_spotify_client_secret SPOTIFY_REDIRECT_URI=http://localhost:8888/callback # These will be filled in after running the auth script: SPOTIFY_ACCESS_TOKEN= SPOTIFY_REFRESH_TOKEN=
4. 运行授权脚本：该脚本将打开您的浏览器，提示您登录 Spotify 并授予权限，然后检索您的初始访问和刷新令牌。
   bun run auth
   该脚本会将SPOTIFY_ACCESS_TOKEN和SPOTIFY_REFRESH_TOKEN打印到控制台。请将这些值复制到您的.env文件中。
5. 配置您的 MCP 客户端：
   • 光标：
     • 打开光标的设置（Cmd+, 或 Ctrl+,）。
     • 搜索“模型上下文协议”。
     • 点击“在settings.json中编辑”。
     • 将以下内容添加到mcp.servers数组（将/absolute/path/to/your/spotify-mcp替换为spotify-mcp目录的绝对路径）：
       { "mcp.servers": [ { "spotify": { "command": "bun", "args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"], "env": { "SPOTIFY_CLIENT_ID": "your_spotify_client_id", "SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret", "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback", "SPOTIFY_ACCESS_TOKEN": "your_spotify_access_token", "SPOTIFY_REFRESH_TOKEN": "your_spotify_refresh_token" } } } ] }
       建议使用.env文件并仅将与 Spotify 相关的环境变量放在那里，而不是将值添加到 settings.json 文件中。
   • 桌面版 Claude（macOS/Windows）：
     • 打开 Claude for Desktop 配置文件：
       • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
       • Windows： %APPDATA%\Claude\claude_desktop_config.json
     • 将以下内容添加到mcpServers对象（将/absolute/path/to/your/spotify-mcp替换为spotify-mcp目录的绝对路径）：GXP6
   • **重要提示：**在客户端配置中始终使用绝对路径。
6. 重启 MCP 客户端确保重新启动 MCP 客户端（Cursor/Claude）以应用设置。

运行服务器