Spotify MCP

基本能力

产品定位

mcp-spotify 是一个用于控制 Spotify 音乐播放的工具，旨在通过命令行或集成开发环境（如 Cursor Composer）提供便捷的音乐播放和管理功能。

核心功能

1. 播放控制：播放、暂停、恢复歌曲。
2. 播放列表管理：显示、播放和管理用户的播放列表。
3. 歌曲搜索：搜索艺术家、歌曲并播放。
4. 队列管理：查看、添加和调整播放队列。
5. 推荐功能：基于当前播放的歌曲推荐相似曲目。
6. 播放状态查询：获取当前播放的歌曲和艺术家信息。
7. 高级功能：跳转到特定位置、设置重复播放等。

适用场景

1. 开发者在工作中控制音乐播放：通过命令行或集成开发环境快速控制音乐播放。
2. 自动化音乐播放：通过脚本或工具自动化音乐播放和管理。
3. 音乐推荐和发现：基于当前播放的歌曲获取推荐曲目。

工具列表

1. Spotify API：用于与 Spotify 服务交互的核心工具。
2. uv：用于运行 Python 脚本的工具。
3. Cursor Composer：用于在集成开发环境中控制 Spotify 播放器。

常见问题解答

1. 如何获取 Spotify API 凭证？
2. 前往 Spotify Developer Dashboard 创建应用并获取凭证。
3. 如何安装和配置 mcp-spotify？
4. 克隆仓库，创建 .env 文件并添加 API 凭证，然后在 Cursor Settings 中添加 MCP 服务器。
5. 如何调试？
6. 确保 Spotify 已打开并在活动设备上运行，然后在 Cursor Composer 中测试命令。

使用教程

使用依赖

1. 安装 uv。
2. 获取 Spotify API 凭证。

安装教程

1. 克隆仓库： bash git clone <repository-url>
2. 创建 .env 文件并添加 Spotify API 凭证（参考 .env.example）。
3. 在 Cursor Settings 中添加 MCP 服务器：
4. Name: Spotify
5. Type: command
6. Command: uv --directory <path-to-repository/mcp-spotify> run main.py

调试方式

1. 打开 Cursor Composer 的 "agent" 模式。
2. 确保 Spotify 已打开并在活动设备上运行。
3. 测试命令，例如：
4. "Show me my playlists."
5. "Play my 'Chill Vibes' playlist."
6. "Pause song."

许可证

None