本项目是一个用于 Spotify 集成的 Model Context Protocol (MCP) 服务器,它能让像 Claude 这类 AI 助手对您的 Spotify 账户进行控制与交互,为音乐管理带来全新体验。
本项目提供了一组 MCP 工具,赋予 AI 助手强大的音乐管理能力:
它基于 Model Context Protocol 和 zmb3/spotify Golang SDK 构建。
Model Context Protocol (MCP) 是一个开放协议,它为大型语言模型(LLMs)与外部系统和数据源的交互提供了标准化的上下文。就像 USB - C 端口为电子设备提供标准连接方式一样,MCP 为 AI 应用提供了一种标准化方式,让 LLMs 如 Claude 能以安全且规范的方式与不同数据源和工具连接。本项目实现了一个符合 MCP 规范的 Spotify 服务器,使 AI 助手可以控制和交互您的 Spotify 账户。
http://127.0.0.1:1690/callback
要与 Claude Desktop 一起使用此服务器:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"spotify": {
"command": "/path/to/spotify-mcp-binary",
"env": {
"SPOTIFY_CLIENT_ID": "your_client_id_here",
"SPOTIFY_CLIENT_SECRET": "your_client_secret_here"
}
}
}
}
spotify_login
工具进行身份验证spotify_login
- 开始 Spotify 身份验证过程以控制 playbackplay
- 在您的 Spotify 账户上开始或恢复 playbackpause
- 暂停您的 Spotify 账户上的 playbacknext_track
- 跳到当前播放队列中的下一曲previous_track
- 跳到当前播放队列中的前一曲shuffle
- 切换您的 Spotify 账户的 shuffle 模式current_track
- 获取当前正在播放的曲目的信息get_queue
- 获取当前 playback 队列add_tracks_to_queue
- 将曲目添加到当前 playback 队列get_playlist
- 获取特定播放列表的详细信息get_playlist_tracks
- 获取播放列表中的曲目create_playlist
- 创建新的 Spotify 播放列表add_tracks_to_playlist
- 向播放列表添加曲目remove_tracks_from_playlist
- 从播放列表中移除曲目get_user_playlists
- 获取用户的所有播放列表该项目采用 MIT License,详情请访问 MIT License。
如果您希望为该项目做出贡献,请参考我们的 Contributing Guide,了解如何参与项目。