Spotify MCP Server

基本能力

产品定位

Spotify MCP Server 是一个媒体控制协议（MCP）服务器，旨在提供统一的接口来控制 Spotify 播放，支持跨设备和应用程序的集成。

核心功能

• 控制 Spotify 播放（播放、暂停、跳过、上一曲）
• 调节音量
• 搜索并播放特定曲目、专辑或播放列表
• 获取当前播放信息
• 提供 RESTful API 以便与其他应用程序集成
• 支持 AI 助手集成，通过自然语言控制 Spotify
• 提供语音控制接口，支持语音命令控制 Spotify

适用场景

• 跨设备控制 Spotify 播放
• 通过 AI 助手或语音命令控制 Spotify
• 与其他应用程序集成，实现自动化播放控制

工具列表

1. 命令行界面 (CLI)：通过终端控制 Spotify 播放。
2. AI 助手集成：支持通过自然语言命令控制 Spotify。
3. 语音控制接口：支持通过语音命令控制 Spotify。

常见问题解答

• 端口冲突：修改 .env 文件中的端口号（PORT、BRIDGE_PORT、VOICE_PORT）。
• 认证问题：确保访问 http://localhost:8888 并完成 Spotify 认证。
• 语音控制不工作：确保使用兼容的浏览器（推荐 Chrome），并检查麦克风权限。
• “无活动设备”错误：先在 Spotify 上开始播放内容。

使用教程

使用依赖

• Node.js (v16 或更高版本)
• npm (v8 或更高版本)
• Spotify Premium 账户
• Spotify 开发者账户及注册应用

安装教程

1. 克隆仓库： bash git clone https://github.com/Jopgood/spotify-mcp-server.git cd spotify-mcp-server
2. 安装依赖： bash npm install
3. 创建 .env 文件并填写以下内容： CLIENT_ID=your_spotify_client_id CLIENT_SECRET=your_spotify_client_secret REDIRECT_URI=http://localhost:8888/callback PORT=8888 SESSION_SECRET=your_random_session_secret AI_WEBHOOK_API_KEY=your_secure_api_key_for_ai_assistant BRIDGE_PORT=3001 VOICE_PORT=3002
4. 在 Spotify 开发者仪表板 注册应用并获取 Client ID 和 Secret。

调试方式

1. 启动 MCP 服务器： bash npm start
2. 打开浏览器访问 http://localhost:8888 完成 Spotify 认证。
3. 使用 API 端点控制 Spotify，例如： bash curl -X POST http://localhost:8888/api/play

许可证

该项目遵循 MIT 开源许可条款。