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"
}
}
}
}
注意事项
- 确保Spotify应用已开启并正在播放音乐
- 某些功能需要Spotify Premium账户
- Token会自动刷新，无需手动重新认证
- 设备ID参数为可选，不指定时使用当前活动设备
许可证
MIT