AI导哈

Spotify音乐控制服务

一个基于MCP协议连接Claude与Spotify的服务，提供音乐播放控制、搜索及播放列表管理功能。

  • by varunneal
  • Python
  • 本地部署
  • 613 星标
  • 更新于
在 GitHub 查看 varunneal/spotify-mcp

使用说明

spotify mcp mcp服务器

MCP项目将克劳德与Spotify连接起来。建在上面 spotipy-dev的API.

【2026年3月通知】：项目处于非活动状态。大多数PR不会被合并。

特性

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

演示

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

配置

获取Spotify API密钥

在上创建帐户 developer.spotify.com。导航到 仪表板. 使用redirect_uri创建应用程序http://127.0.0.1:8080/callback. 您可以选择任何想要的端口，但必须使用http和显式的环回地址（IPv4或IPv6）。

看 这里 了解更多信息/故障排除。 您可能需要重新启动MCP环境（例如Claude Desktop）一两次才能正常工作。

定位MCP配置

对于Cursor、Claude Desktop或任何其他启用MCP的客户端，您必须找到您的配置。

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

  • Windows上的Claude桌面位置： %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工作，请打开一个问题。以下是一些提示：

  1. 确保 uv 已更新。我推荐版本 >=0.54.
  2. 如果在本地克隆，请为项目启用执行权限： chmod -R 755.
  3. 确保您拥有Spotify溢价（运行开发者API所需）。

此MCP将向std-err（如MCP中指定的）规范发出日志。在Mac上，Claude Desktop应用程序应发出这些日志 到 ~/Library/Logs/Claude. 在其他平台上 你可以在这里找到日志.

您可以通过以下方式启动MCP检查器 npm 使用此命令：

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

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

待办事项

不幸的是，一堆很酷的功能 现已弃用 来自Spotify API。大多数新功能将相对较小或对项目的健康有益：

  • 测验。
  • 添加了对管理播放列表的API支持。
  • 添加了对分页搜索结果/播放列表/相册的API支持。

PR感谢！感谢@jamiew、@davidpadbury、@manncodes、@hyuma7、@aanurraj、@JJGO和其他人的贡献。

相关 MCP