Spotify MCP Server

基于Spotify OAuth和MCP协议的Python服务器，提供Spotify音乐控制功能。

功能特性

• ✅ Spotify OAuth认证

• ✅ 获取当前播放状态

• ✅ 播放/暂停控制

• ✅ 上一首/下一首切换

• ✅ 音量控制

• ✅ 播放位置跳转

• ✅ 设备管理

安装

1. 安装依赖：

pip install -e .

2. 配置Spotify OAuth凭据：

   • 访问 Spotify Developer Dashboard

   • 创建应用并获取 Client ID 和 Client Secret

   • 设置重定向URI为 http://127.0.0.1:8000/callback

3. 设置环境变量：

export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret"
export SPOTIFY_REDIRECT_URI="http://127.0.0.1:8000/callback"  # 可选，默认值

使用方法

1. 启动MCP服务器

服务器通过stdio通信，通常由MCP客户端（如Claude Desktop）自动启动。

2. 首次认证

1. 调用 spotify_get_auth_url 工具获取授权URL

2. 在浏览器中访问该URL并完成授权

3. 从回调URL中提取授权码（code参数）

4. 调用 spotify_authenticate 工具，传入授权码完成认证

认证信息会保存在 ~/.spotify_mcp_token.json，后续使用会自动刷新token。

3. 使用控制功能

认证成功后，可以使用以下工具：

• spotify_get_current_playback - 获取当前播放状态

• spotify_pause - 暂停播放

• spotify_next - 下一首

• spotify_previous - 上一首

• spotify_set_volume - 设置音量（0-100）

• spotify_seek - 跳转到指定位置

• spotify_get_devices - 获取可用设备列表

• spotify_play_artist - 搜索并播放指定艺术家的top 10 tracks，如 'Taylor Swift的歌曲'

• spotify_play_song - 根据歌手和歌曲名播放歌曲。例如：播放 Taylor Swift 的 Love Story

MCP客户端配置

在Claude Desktop的配置文件中添加：

{
  "mcpServers": {
    "spotify-mcp": {
      "command": "python",
      "args": ["-m", "spotify_mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret",
        "SPOTIFY_REDIRECT_URI"="http://127.0.0.1:8000/callback"
      }
    }
  }
}

或者使用uv

{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uv",
      "args": ["run", "-m", "spotify_mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret",
        "SPOTIFY_REDIRECT_URI"="http://127.0.0.1:8000/callback"

      }
    }
  }
}

注意事项

• 确保Spotify应用已开启并正在播放音乐

• 某些功能需要Spotify Premium账户

• Token会自动刷新，无需手动重新认证

• 设备ID参数为可选，不指定时使用当前活动设备

许可证

MIT