spotify-mcp MCP服务器

用于连接Claude与Spotify的MCP项目。基于spotipy-dev的API构建。

功能

• 开始、暂停和跳过播放
• 搜索曲目/专辑/艺术家/播放列表
• 获取关于曲目/专辑/艺术家/播放列表的信息
• 管理Spotify队列
• 创建、管理和更新播放列表

示例

<details> <summary> 视频 -- 打开音频 </summary> https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894 </details>

配置

获取Spotify API密钥

在developer.spotify.com创建一个账户。导航到仪表板。 创建一个应用程序，并设置重定向URI为http://127.0.0.1:8080/callback。 你可以选择任意端口，但必须使用http和明确的回环地址（IPv4或IPv6）。

更多信息/故障排除，请参见这里。 你可能需要重启你的MCP环境（例如Claude Desktop）一两次才能正常工作。

定位MCP配置

对于Cursor、Claude Desktop或其他任何支持MCP的客户端，你需要找到你的配置。

• 在MacOS上的Claude Desktop位置：~/Library/Application\ Support/Claude/claude_desktop_config.json

• 在Windows上的Claude Desktop位置：%APPDATA%/Claude/claude_desktop_config.json

使用uvx运行此项目

将以下片段添加到你的MCP配置中。

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "git+https://github.com/varunneal/spotify-mcp",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://127..0.1:8080/callback"
      }
    }
  }
}

本地运行此项目

使用UVX会为每次工具调用打开Spotify重定向URI。为了避免这种情况，你可以通过克隆这个仓库来本地运行该项目：

git clone https://github.com/varunneal/spotify-mcp.git

将其添加到你的MCP配置中，如下所示：

"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://127.0.0.1:8080/callback"
  }
}

故障排除

如果你无法使这个MCP工作，请打开一个问题。这里有一些提示：

1. 确保uv已更新。建议版本>=0.54。
2. 如果本地克隆，启用项目的执行权限：chmod -R 755。
3. 确保你有Spotify Premium（运行开发者API所需）。

此MCP将向标准错误输出日志（如MCP规范所述）。在Mac上，Claude Desktop应用程序应将这些日志输出到~/Library/Logs/Claude。 在其他平台上，你可以在这里找到日志。

你可以通过npm使用以下命令启动MCP Inspector：

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

启动后，Inspector将显示一个可以在浏览器中访问的URL以开始调试。

待办事项

不幸的是，许多很酷的功能已被从Spotify API中废弃。 大多数新功能将是相对较小的或为了项目的健康：

• 测试。
• 添加管理播放列表的API支持。
• 添加分页搜索结果/播放列表/专辑的API支持。

欢迎提交PR！感谢@jamiew、@davidpadbury、@manncodes、@hyuma7、@aanurraj、@JJGO和其他贡献者。