Spotify MCP Server Mdr

🚀 Spotify MCP 服务器

这是一个用于 Spotify 集成的模型上下文协议（MCP）服务器，它能让 AI 助手（如 Claude）对 Spotify 账户进行控制并与之交互，为音乐管理和播放带来全新体验。

🚀 快速开始

本项目提供了一系列 MCP 工具，借助这些工具，AI 助手能够实现以下功能：

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

该项目基于 模型上下文协议 和 zmb3/spotify Golang SDK 构建。

✨ 主要特性

什么是 MCP？

模型上下文协议（MCP）是一个开放协议，它对应用程序如何为大型语言模型（LLMs）提供上下文进行了标准化。这使得像 Claude 这样的 LLMs 能够以安全且标准的方式与外部系统和数据源进行交互。

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 - 跳到当前播放队列中的下一首曲目
• previous_track - 跳到当前播放队列中的上一首曲目
• shuffle - 切换您的 Spotify 账户上的随机播放模式
• current_track - 获取正在播放的曲目的信息
• get_queue - 获取当前播放队列
• get_current_playlist - 获取当前正在播放的播放列表

播放列表管理

• create_playlist - 创建新的播放列表
• add_to_playlist - 将曲目添加到播放列表中
• remove_from_playlist - 从播放列表中删除曲目
• delete_playlist - 删除播放列表
• get_playlists - 获取所有可用播放列表

📄 许可证

该项目的源代码遵循 MIT License。