Spotify MCP 服务器

功能简介

Spotify MCP（Music Control Protocol）服务器是一个用于控制和管理 Spotify 播放的工具，支持以下功能：

• 播放控制：播放、暂停、跳过上一首或下一首
• 创建与管理播放列表：创建新播放列表并添加/删除歌曲
• 认证授权：通过 OAuth 2.0 授权 Spotify 应用

安装指南

先决条件

1. Node.js v16+ 环境
2. Spotify Premium 账户
3. 注册的 Spotify 开发者应用

安装步骤

git clone https://github.com/marcelmarais/spotify-mcp-server.git
cd spotify-mcp-server
npm install
npm run build

配置说明

创建开发者应用

1. 访问 Spotify 开发者控制台
2. 使用 Spotify 账户登录
3. 点击 "创建新应用" 按钮
4. 填写应用名称和描述
5. 同意服务条款并点击 "创建"
6. 在应用详情页获取 Client ID
7. 点击 "显示客户端密钥" 获取 Client Secret
8. 点击 "编辑设置" 并添加重定向 URI（例如 http://localhost:8888/callback）
9. 保存更改

配置文件

创建 spotify-config.json 文件并填写以下内容：

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:8888/callback"
}

认证流程

1. 运行认证脚本：

   npm run auth
   

2. 脚本生成授权 URL，打开浏览器访问该链接
3. 使用 Spotify 账户登录并授权应用
4. 授权完成后，Spotify 会重定向到指定的 URI 并携带代码参数
5. 脚本自动将代码交换为访问令牌和刷新令牌
6. 令牌保存至 spotify-config.json 文件中

集成配置

Claude Desktop 配置

在 Claude 设置文件中添加以下内容：

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["spotify-mcp-server/build/index.js"]
    }
  }
}

Cursor 插件配置

在 Cursor 的 MCP 设置界面，添加服务器命令：

node path/to/spotify-mcp-server/build/index.js

通过以上步骤即可完成 Spotify MCP 服务器的搭建与集成。