spotify-mcp MCP服务器

连接Claude与Spotify的MCP服务器。此varunneal/spotify-mcp的分支增加了智能批处理工具和高级播放列表功能，以优化API使用。

功能

核心功能

• 播放控制：开始、暂停、跳过曲目，管理队列
• 搜索与发现：查找曲目、专辑、艺术家、播放列表，并支持分页
• 实时状态：实时用户资料和播放状态

增强的播放列表工具（本分支新增）

• 智能批处理操作：单个API调用中添加或删除最多100首曲目
• 大型播放列表支持：通过分页高效处理包含1000多首曲目的播放列表
• 高级播放列表管理：创建、修改细节、批量曲目操作
• API优化工作流：智能批处理减少API调用次数达60-80%

安装

1. 获取Spotify API密钥

1. 在developer.spotify.com创建账户
2. 创建应用并设置重定向URI：http://localhost:8888

2. 安装MCP服务器

git clone https://github.com/jamiew/spotify-mcp.git
cd spotify-mcp
uv sync

3. 配置Claude桌面

在Claude桌面配置文件(~/Library/Application Support/Claude/claude_desktop_config.json)中添加：

"spotify": {
  "command": "uv",
  "args": ["--directory", "/path/to/spotify-mcp", "run", "spotify-mcp"],
  "env": {
    "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
    "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
    "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
  }
}

需求：Spotify Premium账户，uv >= 0.54

使用示例

• “创建一个包含20首曲目的放松学习播放列表” → 搜索 + 播放列表创建 + 批量曲目添加
• “显示我‘喜欢的歌曲’播放列表中的前50首曲目” → 大型播放列表的分页
• “找到与Radiohead相似的艺术家并将他们的热门曲目添加到我的队列中” → 搜索 + 艺术家信息 + 队列管理

开发

使用FastMCP框架构建，该框架包含13种专注工具、类型安全的API以及全面的测试覆盖。

使用MCP Inspector进行调试：

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp