Spotify MCP

🚀 Spotify MCP 服務器

這是一個簡單的模型上下文協議（MCP）服務器，允許你通過 Claude 與 Spotify 進行交互。該服務器使 Claude 能夠使用你的 Spotify 賬戶搜索歌曲、創建播放列表、獲取推薦等。

✨ 主要特性

• 在 Spotify 上搜索曲目
• 查看你的 Spotify 個人資料
• 創建播放列表
• 向播放列表添加曲目
• 獲取個性化音樂推薦

📦 安裝指南

1. 前提條件

• Node.js v16 或更高版本
• npm
• 一個 Spotify 賬戶
• 一個已註冊的 Spotify 開發者應用程序

2. 創建 Spotify 開發者應用

1. 訪問 Spotify 開發者控制檯
2. 使用你的 Spotify 賬戶登錄
3. 點擊“創建應用”
4. 填寫應用名稱和描述
5. 添加 http://localhost:8888/callback 作為重定向 URI
6. 記錄你的客戶端 ID 和客戶端密鑰

3. 安裝項目

# 先克隆或下載項目
cd spotify-mcp-server

# 安裝依賴項
npm install

4. 獲取你的 Spotify 令牌

編輯 spotify-auth.js 文件，包含你的客戶端 ID 和客戶端密鑰：

// 用你的 Spotify 應用憑證替換這些內容
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";

然後運行身份驗證腳本：

node spotify-auth.js

這將：

1. 在你的瀏覽器中打開一個 URL
2. 提示你登錄 Spotify
3. 請求你允許訪問你的賬戶
4. 將令牌保存到 secrets.json

5. 構建 MCP 服務器

npm run build

6. 配置 Claude 桌面應用

編輯你的 Claude 桌面應用配置文件：

• 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json 添加以下配置：

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/full/path/to/spotify-mcp-server/build/spotify-mcp-server.js"]
    }
  }
}

將 /full/path/to/spotify-mcp-server 替換為你的項目目錄的實際路徑。

7. 重啟 Claude 桌面應用

關閉並重新打開 Claude 桌面應用以加載新配置。

💻 使用示例

基礎用法

當你開始與 Claude 對話時，你首先需要設置你的 Spotify 憑證：

1. 查看你的 secrets.json 文件以獲取憑證
2. 使用 set-spotify-credentials 工具進行身份驗證
3. 然後使用任何其他 Spotify 工具

示例提示

設置憑證

我想連接到我的 Spotify 賬戶。以下是我從 secrets.json 中獲取的憑證：

工具：set-spotify-credentials
參數：
{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "accessToken": "your_access_token",
  "refreshToken": "your_refresh_token"
}

基本命令

檢查你的賬戶：

你能檢查我在 Spotify 上以誰的身份登錄嗎？

工具：get-current-user
參數：{}

搜索曲目：

搜索 The Weeknd 的歌曲

工具：search-tracks
參數：
{
  "query": "The Weeknd",
  "limit": 5
}

創建播放列表：

創建一個名為“我的漂亮女友”的新播放列表

工具：create-playlist
參數：
{
  "name": "My Pretty pretty girlfriend",
  "description": "For my girlfriend. Created with Claude and the Spotify MCP server"
}

多步驟任務

創建包含歌曲的播放列表：

我想創建一個包含活力歌曲的健身播放列表。首先，搜索一些高能量的歌曲。然後創建一個名為“健身混音”的播放列表，並將這些歌曲添加到其中。

根據喜愛的歌曲獲取推薦：

我喜歡 The Weeknd 的歌曲“Blinding Lights”。你能搜索這首歌，然後找到類似的歌曲，並創建一個包含這些推薦歌曲的播放列表嗎？

📚 詳細文檔

可用工具

🔧 故障排除

• 錯誤：沒有可用的訪問令牌：你需要首先使用 set-spotify-credentials 工具設置你的憑證
• 身份驗證失敗：你的令牌可能已過期。再次運行身份驗證腳本以獲取新的令牌
• 無效的憑證：仔細檢查你是否使用了正確的客戶端 ID 和客戶端密鑰

📄 注意事項

⚠️ 重要提示

• 服務器僅將憑證存儲在內存中
• 每次開始新對話時，你都需要設置憑證
• 如果 Claude 桌面應用重啟，你需要再次設置憑證