AI导哈

Spotify音乐控制服务

一个连接Claude与Spotify的MCP项目，提供播放控制、音乐搜索和队列管理功能。

  • by boristopalov
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 boristopalov/spotify-mcp

使用说明

spotify mcp mcp服务器

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

特性

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

演示

确保打开音频

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

配置

获取Spotify API密钥

在上创建帐户 developer.spotify.com。导航到 仪表板. 使用redirect_uri创建应用程序http://localhost:8888.（您可以选择任何想要的端口，但必须使用http和localhost）。 我将“使用的API”设置为“Web播放SDK”。

在本地运行此项目

此项目尚未针对临时环境进行设置（例如。 uvx 使用）。 通过克隆此仓库在本地运行此项目

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

将此工具添加为mcp服务器。

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/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"
    }
  }

故障排除

如果您无法使此MCP工作，请打开一个问题。以下是一些提示：

  1. 确保 uv 已更新。我推荐版本 >=0.54.
  2. 确保claude拥有该项目的执行权限： chmod -R 755.
  3. 确保您拥有Spotify溢价（运行开发者API所需）。

全部

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

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

部署

（全部）

建筑与出版

准备分发包裹：

  1. 同步依赖关系并更新锁文件：
uv sync
  1. 构建包分发：
uv build

这将在 dist/ 目录。

  1. 发布到PyPI：
uv publish

注意：您需要通过环境变量或命令标志设置PyPI凭据：

  • 令牌： --token 或 UV_PUBLISH_TOKEN
  • 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

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

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

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

相关 MCP