使用说明
spotify mcp
Spotify的MCP（模型上下文协议）服务器。控制播放、搜索音乐、管理播放列表并获得个性化推荐——所有这些都可以通过任何与MCP兼容的客户端（如Claude）完成。
工具
| 工具 | 说明 |
|---|---|
auth-spotify |
通过OAuth与Spotify进行身份验证 |
search-spotify |
搜索曲目、专辑、艺术家或播放列表 |
get-current-playback |
获取当前播放状态（曲目、设备、进度） |
play-track |
在活动设备上播放特定曲目 |
pause-playback |
暂停播放 |
next-track |
跳到下一首曲目 |
previous-track |
跳至上一曲目 |
get-user-playlists |
列出用户的播放列表 |
create-playlist |
创建新的播放列表 |
add-tracks-to-playlist |
将曲目添加到播放列表 |
get-playlist-tracks |
获取播放列表中的曲目 |
rename-playlist |
重命名播放列表（并可选择更新描述/可见性） |
unfollow-playlist |
取消关注（或删除）播放列表 |
get-recommendations |
根据种子曲目、艺术家或流派获取曲目推荐 |
get-top-tracks |
获取用户在一段时间内播放的热门曲目 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
SPOTIFY_CLIENT_ID |
是 | Spotify应用程序客户端ID |
SPOTIFY_CLIENT_SECRET |
是 | Spotify应用程序客户端机密 |
SPOTIFY_REDIRECT_URI |
否 | OAuth重定向URI（默认为 http://127.0.0.1:8888/callback) |
创建Spotify应用程序 developer.spotify.com 并将您的重定向URI添加到应用程序的设置中。
设置
npm ci
用法
Stdio模式（适用于直接启动服务器的MCP客户端）
node build/index.js
HTTP模式（使用mcp代理）
mcp-proxy --port 8002 -- node build/index.js
认证
首次使用时，调用 auth-spotify 工具。它将为Spotify OAuth打开一个浏览器窗口。令牌被持久化 ~/.spotify-mcp/tokens.json 所以你只需要验证一次。
许可证
麻省理工学院