Spotify 多用途控制台（MCP）服务器指南

简介

Spotify 多用途控制台（MCP）服务器是一个基于 Node.js 的工具，允许通过命令行界面（CLI）与 Spotify 服务进行交互。该工具支持多项功能，包括音乐播放控制、数据检索和系统设置等。

功能模块

核心指令

1. 播放控制

   • play: 开始播放音乐
   • pause: 暂停播放
   • resume: 继续播放
   • stop: 停止播放
   • toggle: 切换播放状态（播放/暂停）

2. 媒体操作

   • next: 跳到下一首歌曲
   • previous: 返回上一首歌曲
   • repeat: 启用重复播放模式
   • shuffle: 打乱当前播放列表

3. 音量调节

   • volume <percentage>: 调整音量（范围：0-100）
   • mute: 关闭声音
   • unmute: 打开声音

4. 时间调整

   • seek <seconds>: 跳转到指定秒数
   • replay: 重新播放当前音乐

高级功能

1. 播放列表管理

   • create-playlist "<playlist-name>": 创建新播放列表
   • add-to-playlist "<track-id>" "<playlist-name>": 将歌曲添加到指定播放列表
   • remove-from-playlist "<track-id>" "<playlist-name>": 从播放列表中移除歌曲
   • delete-playlist "<playlist-name>": 删除指定播放列表

2. 收藏管理

   • save-track "<track-id>": 将歌曲添加到"liked"列表
   • remove-track "<track-id>": 从"liked"列表中移除歌曲

3. 用户数据查询

   • get-playlists: 获取所有播放列表信息
   • get-tracks "<playlist-name>": 获取指定播放列表中的所有曲目
   • get-current: 查看当前正在播放的音乐信息
   • search "<query>": 搜索歌曲或艺术家

4. 系统设置

   • set-device "<device-id>": 切换默认声音设备
   • set-destination "<endpoint>": 配置媒体数据传输地址

安装与配置

先决条件

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

创建 Spotify 开发者应用

1. 访问 Spotify 开发者控制台
2. 使用您的 Spotify 账户登录
3. 点击"创建新应用"按钮
4. 填写应用名称和描述
5. 接受服务条款并点击"创建"
6. 在新应用的仪表盘中，查看您的客户端 ID
7. 点击"显示客户端密钥"以显示您的客户端密钥
8. 点击"编辑设置"并添加一个重定向 URI（例如：http://localhost:8888/callback）
9. 保存更改

Spotify API 配置

创建项目根目录下的 spotify-config.json 文件（您可以复制并修改提供的示例）：

cp example.spotify-config.json .spotify-config.json

编辑配置文件：

{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "redirectUri": "http://localhost:8888/callback"
}

使用示例

授权登录

运行以下命令，使用您的 Spotify 账户进行授权：

npm run authorize

按照提示完成 OAuth 流程。

基本操作

• 播放音乐：npm run play
• 暂停播放：npm run pause
• 下一首：npm run next
• 上一首：npm run previous

复杂任务

• 创建新播放列表：

  npm run create-playlist "My New Playlist"
  

• 将歌曲添加到播放列表：

  npm run add-to-playlist "123456789" "My New Playlist"
  

高级配置

环境变量设置

您可以使用以下环境变量来进一步定制工具：

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback

将这些变量添加到您的 .env 文件中。

集成与扩展

与开发工具结合使用

1. Claude Desktop

   • 安装 Claude 插件
   • 配置环境变量
   • 使用命令调用 Spotify 功能

2. Cursor

   • 安装 Cursor 插件
   • 添加自定义快捷方式
   • 集成 MCP 服务

3. VS Code

   • 安装对应的扩展
   • 配置启动任务
   • 使用插件进行操作

参考资料

• Node.js 官方文档
• Spotify API 文档
• 开发者指南

通过以上步骤，您可以轻松配置和使用 Spotify 多用途控制台服务器，实现对 Spotify 服务的高效管理和自动化操作。