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 服務器。