MCP Server For Spotify

🚀 Spotify MCP 服務器

Spotify MCP 服務器與 Spotify API 集成，藉助該服務器，您能夠通過 Claude 便捷地管理和創建播放列表，輕鬆滿足音樂管理需求。

✨ 主要特性

• 可搜索曲目、藝術家和專輯，快速定位心儀音樂。
• 支持創建和修改播放列表，隨心定製專屬歌單。
• 能瀏覽用戶播放列表，回顧已有收藏。
• 可根據曲目、藝術家和流派獲取推薦，發現更多好音樂。

📦 安裝指南

認證設置

1. 在 Spotify 開發者控制檯 創建一個 Spotify 應用。
2. 將重定向 URI 設置為 http://localhost:8888/callback。
3. 使用隨附的認證應用程序獲取您的刷新令牌：

# 進入 auth-app 目錄
cd auth-app

# 安裝依賴項
npm install

# 運行認證應用程序
npm start

4. 在瀏覽器中按照說明授權並獲取您的刷新令牌。
5. 設置所需的環境變量：

export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
export SPOTIFY_REFRESH_TOKEN="your-refresh-token"

運行服務器

設置好環境變量後，可以運行以下命令啟動服務器：

# 從根目錄
npm install
npm run build
node dist/index.js

Docker 使用

您也可以使用 Docker 構建並運行服務器：

# 構建 Docker 鏡像
podman build -t mcp/spotify -f src/spotify/Dockerfile .

# 使用環境變量運行容器
podman run -e SPOTIFY_CLIENT_ID="your-client-id" \
  -e SPOTIFY_CLIENT_SECRET="your-client-secret" \
  -e SPOTIFY_REFRESH_TOKEN="your-refresh-token" \
  mcp/spotify

💻 使用示例

與 Claude 結合使用

在您的服務器配置中添加以下內容：

{
  "mcpServers": {
    "spotify": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOTIFY_CLIENT_ID=your-client-id",
        "-e",
        "SPOTIFY_CLIENT_SECRET=your-client-secret",
        "-e",
        "SPOTIFY_REFRESH_TOKEN=your-refresh-token",
        "mcp/spotify"
      ]
    }
  }
}

提示詞使用

一旦 MCP 服務器運行，Claude 可以利用它來：

1. 在 Spotify 上搜索音樂。
2. 根據主題或流派創建播放列表。
3. 添加曲目到播放列表。
4. 瀏覽您的現有播放列表。
5. 獲取基於您的音樂偏好的推薦。

只需讓 Claude 創建一個播放列表或查找音樂，它將利用適當的 Spotify API 工具通過 MCP 服務器進行操作。