🚀 Spotify MCP 工具

这是一款便捷快速的 Spotify MCP（机器控制协议）工具，借助它，你可以通过 Cursor 轻松控制 Spotify 播放器，实现播放、暂停、搜索等一系列操作，为你的音乐体验增添更多便利。

🚀 快速开始

演示

点击以下链接查看演示：演示链接

先决条件

• uv
• Spotify API

📦 安装指南

1. 克隆此仓库。
2. 在仓库根目录中创建一个 .env 文件，并添加您的 Spotify API 凭证（从 .env.example 复制）。您可以在 Spotify 开发者仪表盘 创建应用后获取这些凭证。
3. 前往 Cursor 设置 > 功能 > MCP 服务器 > + 添加新的 MCP 服务器。
   • 名称：Spotify
   • 类型：命令
   • 命令：uv --directory <仓库路径/mcp-spotify> run main.py

安装成功后，您将看到如下界面：

试用方法

打开 Composer 以“代理”模式，并启动，即可通过 Cursor 控制您的 Spotify 播放器（请确保 Spotify 正在活跃设备上运行）。

✨ 主要特性

💻 使用示例

以下是通过 Cursor Composer 与 Spotify MCP 工具交互的示例对话：

1. 用户: "显示我的播放列表。"
   响应: "这是您的播放列表：轻松 vibes, Workout Mix, Top Hits."
2. 用户: "播放我的'Chill Vibes'播放列表。"
3. 用户: "暂停歌曲。"
   响应: "播放已暂停。"
4. 用户: "恢复播放。"
   响应: "正在继续播放..."
5. 用户: "这是什么歌？"
   响应: "您正在收听'Faded' by Alan Walker。"
6. 用户: "告诉我这个艺术家的信息并显示一些热门曲目。"
   响应: "艺术家信息：Alan Walker。"
7. 用户: "显示我过去 6 个月内的最常听的艺术家。"
   响应: "以下是您最常收听的艺术家..."
8. 用户: "搜索 Coldplay。"
   响应: "找到艺术家：Coldplay。以下是他们的热门曲目..."
9. 用户: "播放'Fix You'这首歌。"
   响应: "开始播放'Fix You'..."
10. 用户: "显示我的队列。"
    响应: "当前队列：Track 1, Track 2, Track 3..."
11. 用户: "将'Paradise'添加到我的队列中。"
    响应: "已将'Paradise' by Coldplay 添加到您的队列中。"
12. 用户: "将'Paradise'提前到队列中的位置。"
13. 用户: "设置为循环播放。"
14. 用户: "我喜欢这首歌，推荐一些类似的歌曲。"
    响应: "基于这首歌曲的推荐曲目在此..."
15. 用户: "将此曲添加到我的'Chill Vibes'播放列表中。"

额外可用功能

• 移动到歌曲的特定位置
• 查看详细的播放状态
• 跳过多首歌曲

如果您希望支持更多功能，请随时提出问题！