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 服務的高效管理和自動化操作。