金大哥 - spotify-mcp-server-cv6 MCP 详情

article

README

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

Spotify 多用途控制台（MCP）服务器是一款基于 Node.js 的实用工具，它借助命令行界面（CLI），让用户能够便捷地与 Spotify 服务进行交互。该工具功能丰富，涵盖音乐播放控制、数据检索以及系统设置等多个方面。

🚀 快速开始

Spotify 多用途控制台（MCP）服务器可让你通过命令行与 Spotify 服务交互。以下是使用前的准备步骤：

确保已安装 Node.js v16+，拥有 Spotify Premium 账户，并注册了 Spotify 开发者应用。
按照安装步骤完成工具的安装与配置。
完成授权登录后，即可使用各种指令控制音乐播放、管理播放列表等。

✨ 主要特性

核心指令

播放控制
- play：开始播放音乐。
- pause：暂停播放。
- resume：继续播放。
- stop：停止播放。
- toggle：切换播放状态（播放/暂停）。
媒体操作
- next：跳到下一首歌曲。
- previous：返回上一首歌曲。
- repeat：启用重复播放模式。
- shuffle：打乱当前播放列表。
音量调节
- volume <percentage>：调整音量（范围：0 - 100）。
- mute：关闭声音。
- unmute：打开声音。
时间调整
- seek <seconds>：跳转到指定秒数。
- replay：重新播放当前音乐。

高级功能

播放列表管理
- create - playlist "<playlist - name>"：创建新播放列表。
- add - to - playlist "<track - id>" "<playlist - name>"：将歌曲添加到指定播放列表。
- remove - from - playlist "<track - id>" "<playlist - name>"：从播放列表中移除歌曲。
- delete - playlist "<playlist - name>"：删除指定播放列表。
收藏管理
- save - track "<track - id>"：将歌曲添加到"liked"列表。
- remove - track "<track - id>"：从"liked"列表中移除歌曲。
用户数据查询
- get - playlists：获取所有播放列表信息。
- get - tracks "<playlist - name>"：获取指定播放列表中的所有曲目。
- get - current：查看当前正在播放的音乐信息。
- search "<query>"：搜索歌曲或艺术家。
系统设置
- set - device "<device - id>"：切换默认声音设备。
- set - destination "<endpoint>"：配置媒体数据传输地址。

📦 安装指南

先决条件

已安装 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

创建 Spotify 开发者应用

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

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 文件中。

集成与扩展

与开发工具结合使用

Claude Desktop
- 安装 Claude 插件。
- 配置环境变量。
- 使用命令调用 Spotify 功能。
Cursor
- 安装 Cursor 插件。
- 添加自定义快捷方式。
- 集成 MCP 服务。
VS Code
- 安装对应的扩展。
- 配置启动任务。
- 使用插件进行操作。

🔗 参考资料

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

spotify-mcp-server-cv6