
spotify-mcp-server

2025.04.21
0
Python音乐服务Spotify集成娱乐功能
spotify-mcp-server 是一个与 Spotify 音乐服务集成的 MCP 服务器,允许用户通过 MCP 代理与 Spotify Web API 进行交互。它需要 Spotify 开发者账号的客户端 ID 和密钥,并支持通过 SSE (Server-Sent Events) 进行通信。
View on GitHub
Overview
基本能力
产品定位
spotify-mcp-server 是一个音乐服务集成工具,专门用于与 Spotify 音乐平台进行交互。
核心功能
- 与 Spotify Web API 集成
- 支持 OAuth 2.0 认证流程
- 通过 SSE (Server-Sent Events) 提供实时数据
- 可作为 MCP 代理的后端服务
适用场景
- 开发音乐相关的桌面应用
- 构建 Spotify 集成工具
- 创建音乐播放器或管理工具
工具列表
generate-client.sh
: 生成客户端脚本uv
: 用于运行服务器mcp-proxy
: 用于代理 SSE 连接
常见问题
- 需要有效的 Spotify 开发者账号
- 需要正确设置回调 URL
- 需要提供有效的客户端 ID 和密钥
使用教程
使用依赖
- 安装
uv
:sh # 安装 uv (假设使用 pip) pip install uv
- 创建 Spotify 开发者应用并设置回调 URL 为
http://127.0.0.1:8000/callback
安装教程
- 运行生成客户端脚本:
sh ./generate-client.sh
- 启动服务器:
sh SPOTIFY_CLIENT_ID=<client_id> SPOTIFY_CLIENT_SECRET=<client_secret> uv run spotify-mcp-server
调试方式
- 检查服务器是否运行在
http://127.0.0.1:8000
- 使用 MCP 代理配置测试连接:
json { "Spotify": { "command": "uvx", "args": ["mcp-proxy", "http://127.0.0.1:8000/sse"] } }
- 验证回调 URL 是否正确处理认证流程