spotify-mcp MCP server

基本能力

产品定位

spotify_mcp 是一个音乐播放和管理服务，通过 MCP 协议连接 Claude 与 Spotify，提供丰富的音乐控制功能。

核心功能

• 开始、暂停和跳过播放
• 搜索歌曲、专辑、艺术家和播放列表
• 获取歌曲、专辑、艺术家和播放列表的信息
• 管理 Spotify 播放队列

适用场景

• 通过 Claude 控制 Spotify 播放音乐
• 搜索和管理 Spotify 音乐内容
• 获取音乐相关信息

工具列表

• spotipy-dev API: 提供 Spotify 音乐播放和管理的 API 接口
• MCP Inspector: 用于调试 MCP 服务的工具

常见问题解答

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

使用教程

使用依赖

1. 创建 Spotify 开发者账号并获取 API Keys
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"
  }
}

调试方式

1. 使用 MCP Inspector 进行调试:

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

1. 查看日志:
2. Mac: ~/Library/Logs/Claude
3. 其他平台: 参考 MCP 文档

许可证

None