Spotify MCP Server (express.js)

🚀 Spotify MCP 服務器（Express.js）

這是一個實現模型上下文協議（MCP）的 Spotify 服務器，它能讓 AI 助手與 Spotify 的 API 進行交互。該服務器具備搜索曲目、獲取藝術家信息以及管理播放列表等功能，為用戶提供便捷的音樂交互體驗。

🚀 快速開始

本服務器允許 AI 助手與 Spotify 的 API 進行交互，實現搜索曲目、獲取藝術家信息等功能。

📦 安裝指南

1. 在 Spotify 開發者控制檯創建一個開發者賬戶，並在 Spotify 開發者儀表盤 創建一個新的應用。
2. 從你的 Spotify 應用中獲取 客戶端 ID 和 客戶端密鑰。
3. 在項目根目錄下創建一個 .env 文件，內容如下：

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:3000/callback

4. 安裝依賴項：

npm install

5. 啟動服務器：

npm start

✨ 主要特性

該服務器實現了以下 MCP 端點：

• POST /mcp/search - 搜索曲目、藝術家或專輯。
• GET /mcp/artist/{artistId} - 獲取藝術家的詳細信息。
• GET /mcp/track/{trackId} - 獲取曲目的詳細信息。
• GET /mcp/playlist/{playlistId} - 獲取播放列表的信息。
• GET /mcp/me/top-tracks - 獲取用戶的最常聽歌曲（需要身份驗證）。
• GET /mcp/me/playlists - 獲取用戶的所有播放列表（需要身份驗證）。
• GET /mcp/me/tracks - 獲取用戶的收藏曲目（需要身份驗證）。
• GET /mcp/auth/login - 生成 Spotify 登錄 URL 進行用戶身份驗證。
• GET /callback - 處理 Spotify OAuth 回調並交換授權碼為訪問令牌。
• POST /mcp/auth/refresh - 刷新用戶的訪問令牌。

💻 使用示例

基礎用法

// 搜索曲目
const searchResponse = await fetch('http://localhost:3000/mcp/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'Bohemian Rhapsody',
    type: 'track'
  })
});
const searchData = await searchResponse.json();

// 獲取藝術家信息
const artistResponse = await fetch('http://localhost:3000/mcp/artist/1dfeR4HaWDbWqJHLk5g1d1');
const artistData = await artistResponse.json();

📚 詳細文檔

該服務器實現了模型上下文協議，允許 AI 助手：

1. 使用 Spotify 進行身份驗證。
2. 搜索音樂內容。
3. 獲取藝術家、曲目和播放列表的詳細信息。
4. 訪問用戶個性化數據（需進行適當的身份驗證）。

🔧 技術細節

服務器通過環境變量管理敏感憑證，以確保安全。

📄 許可證

文檔未提及相關內容，故跳過該章節。

⚠️ 重要提示

確保 .env 文件的安全性，切勿將其提交到版本控制。