spotify_mcp

spotify_mcp

项目描述

该项目是使用 Model Context Protocol（MCP）构建的 Spotify 集成。它提供一组工具和资源，可与 Spotify API 交互，从而通过 MCP 框架控制播放、访问用户数据等。

设置

按照以下步骤启动并运行该项目：

1. 克隆代码库：

   git clone https://github.com/jmoro0408/spotify_mcp.git
   cd spotify_mcp
   

2. 设置虚拟环境（推荐）：

   python -m venv .venv
   source .venv/bin/activate
   

3. 安装依赖项：

   uv sync
   

4. 设置 Spotify API 凭据：

   • 前往 Spotify Developer Dashboard。
   • 登录并创建一个新应用。
   • 记下你的 Client ID 和 Client Secret。
   • 添加一个重定向 URI。本地开发通常使用 http://localhost:8888/callback。
   • 在项目根目录中创建一个 .env 文件，并写入以下内容：

     SPOTIPY_CLIENT_ID='YOUR_CLIENT_ID'
     SPOTIPY_CLIENT_SECRET='YOUR_CLIENT_SECRET'
     SPOTIPY_REDIRECT_URI='YOUR_REDIRECT_URI'
     

     将占位值替换为你的实际凭据和重定向 URI。

5. 运行服务：

   python src/server.py
   

   这将启动 MCP 服务，使 Spotify 工具和资源可用。

用法

配置并运行服务后，你就可以通过定义的 MCP 工具与 Spotify API 交互。与 MCP 工具交互的具体方法取决于你使用的、支持 MCP 的客户端应用或框架。

如果使用 Claude 作为 MCP 客户端，需要编辑 claude_desktop_config.json 并加入：

{
  "mcpServers": {
    "Spotify_MCP": {
      "command": "<FULL_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "spotipy",
        "mcp",
        "run",
        <FULL_PATH_TO_MAIN.py>
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<REDIRECT_URI>"
      }
    }
  }
}

当前支持的操作

1. 播放歌曲
2. 获取用户的播放列表
3. 播放用户播放列表中的内容
4. 播放 Spotify 播放列表中的内容，例如排行榜
5. 暂停播放
6. 跳到下一首
7. 跳到上一首
8. 开启随机播放
9. 关闭随机播放
10. 播放用户点赞的歌曲
11. 获取最近播放的歌曲
12. 添加到队列
13. 获取本周／本月／本年度播放次数最多的歌曲

待实现

1. 将歌曲添加到播放列表
2. 将曲目添加到播放列表
3. 创建播放列表
4. 获取近期热门歌曲，即我最近发现并经常播放的歌曲。
5. 生成由大模型驱动的播放列表，例如：“根据我最近喜欢的艺人创建一个舞蹈健身播放列表”

项目结构

• src/auth.py：处理 Spotify API 身份验证。
• src/main.py：可能是应用的主入口或核心逻辑。
• src/resources.py：定义用于访问 Spotify 数据的 MCP 资源。
• src/server.py：MCP 服务实现。
• src/tools.py：定义用于与 Spotify API 交互的 MCP 工具（即上文列出的支持操作）。
• src/utils.py：项目中使用的实用函数。