spotify-mcp MCP server

基本能力

产品定位

spotify-mcp 是一个音乐服务工具，允许用户通过 Claude 控制 Spotify 的音乐播放、搜索和管理功能。

核心功能

• 控制音乐播放：开始、暂停、跳过播放
• 搜索功能：搜索曲目、专辑、艺术家、播放列表
• 获取信息：获取曲目、专辑、艺术家、播放列表的详细信息
• 管理队列：管理 Spotify 播放队列

适用场景

• 通过 Claude 控制 Spotify 音乐播放
• 快速搜索和播放音乐
• 管理音乐播放队列

工具列表

• spotipy-dev API：用于与 Spotify 服务交互
• MCP Inspector：用于调试 MCP 服务器

常见问题解答

1. 确保 uv 版本 >= 0.54
2. 确保 Claude 对项目有执行权限：chmod -R 755
3. 需要 Spotify Premium 会员才能使用开发者 API

使用教程

使用依赖

1. 创建 Spotify 开发者账号并获取 API 密钥
2. 设置重定向 URI 为 http://localhost:8888

安装教程

1. 克隆仓库：

git clone https://github.com/varunneal/spotify-mcp.git

1. 配置 MCP 服务器：

"spotify": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/spotify_mcp",
    "run",
    "spotify-mcp"
  ],
  "env": {
    "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
    "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
    "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
  }
}

调试方式

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

许可证

None