spotify-mcp-server

spotify-mcp-server

site icon
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 和密钥

使用教程

使用依赖

  1. 安装 uv: sh # 安装 uv (假设使用 pip) pip install uv
  2. 创建 Spotify 开发者应用并设置回调 URL 为 http://127.0.0.1:8000/callback

安装教程

  1. 运行生成客户端脚本: sh ./generate-client.sh
  2. 启动服务器: sh SPOTIFY_CLIENT_ID=<client_id> SPOTIFY_CLIENT_SECRET=<client_secret> uv run spotify-mcp-server

调试方式

  1. 检查服务器是否运行在 http://127.0.0.1:8000
  2. 使用 MCP 代理配置测试连接: json { "Spotify": { "command": "uvx", "args": ["mcp-proxy", "http://127.0.0.1:8000/sse"] } }
  3. 验证回调 URL 是否正确处理认证流程

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。