Spotify MCP

spotify-mcp MCP 服务

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

[通知：2026 年 3 月]：项目已停止维护。大多数 PR 将不会合并。

功能

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

演示

视频 -- 打开音频

https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894

配置

获取 Spotify API 密钥

在 developer.spotify.com 创建帐户。前往控制台。 创建应用，并将 http://127.0.0.1:8080/callback 设为 redirect_uri。 端口可以任意选择，但必须使用 http 和明确的环回地址（IPv4 或 IPv6）。

请参阅此处了解更多信息／排查问题。 可能需要重启 MCP 环境（例如 Claude Desktop）一两次才能正常运行。

查找 MCP 配置

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

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

• Claude Desktop 在 Windows 上的位置：%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.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 正常运行，请提交 issue。以下是一些建议：

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，你可以在浏览器中访问该 URL 以开始调试。

待办事项

遗憾的是，Spotify API 中的许多酷炫功能现已弃用。 大多数新功能都会相对小众，或用于维护项目健康：

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

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