Spotify MCP 服务器

一个用于 Spotify 集成的模型上下文协议 (MCP) 服务器，允许像 Claude 这样的 AI 助手控制和与您的 Spotify 帐户交互。

概述

该项目提供了一组 MCP 工具，使 AI 助手能够：

• 搜索播放列表
• 检索播放列表详细信息和曲目
• 控制播放（播放、暂停、跳过、上一首）
• 创建和修改播放列表
• 切换随机播放模式
• 查看当前播放的曲目
• 将曲目添加到队列

构建于 模型上下文协议 和 zmb3/spotify Golang SDK 之上。

什么是 MCP？

模型上下文协议 (MCP) 是一种开放协议，它标准化了应用程序如何向大型语言模型 (LLM) 提供上下文。 它允许像 Claude 这样的 LLM 以安全和标准化的方式与外部系统和数据源交互。

MCP 就像 AI 应用程序的 USB-C 端口 - 提供了一种将 AI 模型连接到不同数据源和工具的标准方式。 该项目实现了一个遵循 MCP 规范的 Spotify 服务器，使 AI 助手能够控制和与您的 Spotify 帐户交互。

设置

前提条件

1. Go 1.18 或更高版本
2. 一个 Spotify 帐户（您需要 Spotify Premium 才能进行播放控制）
3. Spotify 开发者凭据

获取 Spotify API 凭据

1. 访问 Spotify 开发者仪表板
2. 使用您的 Spotify 帐户登录
3. 点击 "创建应用"
4. 填写应用程序名称和描述
5. 创建完成后，您将看到您的 客户端 ID，并且可以查看您的 客户端密钥
6. 将重定向 URI 设置为 http://127.0.0.1:1690/callback

与 Claude 一起使用

要将此服务器与 Claude for Desktop 一起使用：

1. 打开 Claude for Desktop

2. 在以下位置创建或更新您的 MCP 配置：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 添加以下配置：

{
  "mcpServers": {
    "spotify": {
      "command": "/path/to/spotify-mcp-binary",
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

4. 重新启动 Claude for Desktop
5. 首次使用 Spotify 工具时，您需要使用 spotify_login 工具进行身份验证

可用工具

播放

• spotify_login - 启动 Spotify 身份验证过程以进行播放控制
• play - 在您的 Spotify 帐户上开始或恢复播放
• pause - 暂停您的 Spotify 帐户上的播放
• next_track - 跳到您的 Spotify 队列中的下一首曲目
• previous_track - 跳到您的 Spotify 队列中的上一首曲目
• shuffle - 切换您的 Spotify 帐户上的随机播放模式
• current_track - 获取有关当前播放曲目的信息
• get_queue - 获取当前播放队列
• add_tracks_to_queue - 将曲目添加到当前播放队列

播放列表

• get_playlist - 获取有关特定播放列表的详细信息
• get_playlist_tracks - 获取播放列表中的曲目
• create_playlist - 创建一个新的 Spotify 播放列表
• add_tracks_to_playlist - 将曲目添加到播放列表
• remove_tracks_from_playlist - 从播放列表中删除曲目
• get_user_playlists - 获取 Spotify 用户的播放列表

搜索

• simple_playlist_and_album_search - 按名称搜索播放列表或专辑
• simple_song_search - 按名称搜索歌曲

许可证

MIT 许可证

致谢

• 使用 zmb3/spotify Golang SDK 构建
• 实现了 模型上下文协议
• 受益于不断增长的 MCP 服务器生态系统

贡献

欢迎贡献！ 请随时提交 Pull Request。