Spotify MCP Server Cv6

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

Spotify 多用途控制台（MCP）服务器是一款基于 Node.js 的实用工具，它能让你通过命令行界面（CLI）与 Spotify 服务进行交互。借助该工具，你可以轻松实现音乐播放控制、数据检索以及系统设置等多项功能。

🚀 快速开始

Spotify 多用途控制台（MCP）服务器能让你通过命令行便捷地与 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

创建 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"
}

✨ 主要特性

核心指令

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>"：配置媒体数据传输地址

💻 使用示例

授权登录

运行以下命令，使用你的 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 服务的高效管理和自动化操作。