🚀 Spotify MCP 服务器

本项目是一个用于 Spotify 集成的 Model Context Protocol (MCP) 服务器，它能让像 Claude 这类 AI 助手对您的 Spotify 账户进行控制与交互，为音乐管理带来全新体验。

🚀 快速开始

本项目提供了一组 MCP 工具，赋予 AI 助手强大的音乐管理能力：

• 搜索播放列表
• 获取播放列表详细信息和曲目
• 控制 playback（播放、暂停、跳过、上一曲）
• 创建和修改播放列表
• 切换 shuffle 模式
• 查看当前正在播放的曲目
• 将曲目添加到队列中

它基于 Model Context Protocol 和 zmb3/spotify Golang SDK 构建。

✨ 主要特性

什么是 MCP？

Model Context Protocol (MCP) 是一个开放协议，它为大型语言模型（LLMs）与外部系统和数据源的交互提供了标准化的上下文。就像 USB - C 端口为电子设备提供标准连接方式一样，MCP 为 AI 应用提供了一种标准化方式，让 LLMs 如 Claude 能以安全且规范的方式与不同数据源和工具连接。本项目实现了一个符合 MCP 规范的 Spotify 服务器，使 AI 助手可以控制和交互您的 Spotify 账户。

📦 安装指南

先决条件

1. Go 1.18 或更高版本
2. 一个 Spotify 账户（您需要 Spotify Premium 才能进行 playback 控制）
3. Spotify 开发人员凭证

获取 Spotify API 凭证

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

与 Claude 使用

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

1. 打开 Claude 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 Desktop
5. 第一次使用 Spotify 工具时，您需要通过 spotify_login 工具进行身份验证

💻 使用示例

可用工具

Playback（播放）

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

Playlist（播放列表）

• get_playlist - 获取特定播放列表的详细信息
• get_playlist_tracks - 获取播放列表中的曲目
• create_playlist - 创建新的 Spotify 播放列表
• add_tracks_to_playlist - 向播放列表添加曲目
• remove_tracks_from_playlist - 从播放列表中移除曲目
• get_user_playlists - 获取用户的所有播放列表

📄 许可证

该项目采用 MIT License，详情请访问 MIT License。

🤝 贡献指南

如果您希望为该项目做出贡献，请参考我们的 Contributing Guide，了解如何参与项目。