marcelmarais_spotify-mcp-server

🚀 Spotify MCP 服务器

Spotify MCP（Music Control Protocol）服务器是一款用于控制和管理 Spotify 播放的实用工具。它具备播放控制、播放列表管理以及认证授权等功能，能为用户带来便捷的音乐控制体验。

🚀 快速开始

按照以下步骤，你可以轻松搭建并集成 Spotify MCP 服务器。

✨ 主要特性

• 播放控制：支持播放、暂停、跳过上一首或下一首等操作，让你随心掌控音乐播放。
• 创建与管理播放列表：能够创建新的播放列表，并自由添加或删除歌曲。
• 认证授权：通过 OAuth 2.0 对 Spotify 应用进行授权，保障使用的安全性。

📦 安装指南

先决条件

• Node.js v16+ 环境
• Spotify Premium 账户
• 已注册的 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 服务器。