Spotify MCP Server

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

功能特性

✅ Spotify OAuth认证
✅ 获取当前播放状态
✅ 播放/暂停控制
✅ 上一首/下一首切换
✅ 音量控制
✅ 播放位置跳转
✅ 设备管理

安装

安装依赖：

pip install -e .

配置Spotify OAuth凭据：
- 访问 Spotify Developer Dashboard
- 创建应用并获取 Client ID 和 Client Secret
- 设置重定向URI为 http://127.0.0.1:8000/callback
设置环境变量：

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. 首次认证

调用 spotify_get_auth_url 工具获取授权URL
在浏览器中访问该URL并完成授权
从回调URL中提取授权码（code参数）
调用 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" } } } }