Spotify MCP Server Mdr

🚀 Spotify MCP 服務器

這是一個用於 Spotify 集成的模型上下文協議（MCP）服務器，它能讓 AI 助手（如 Claude）對 Spotify 賬戶進行控制並與之交互，為音樂管理和播放帶來全新體驗。

🚀 快速開始

本項目提供了一系列 MCP 工具，藉助這些工具，AI 助手能夠實現以下功能：

• 搜索播放列表
• 獲取播放列表詳細信息和曲目
• 控制播放（播放、暫停、跳過、上一曲）
• 創建和修改播放列表
• 切換隨機播放模式
• 查看當前播放的曲目
• 將曲目添加到隊列

該項目基於 模型上下文協議 和 zmb3/spotify Golang SDK 構建。

✨ 主要特性

什麼是 MCP？

模型上下文協議（MCP）是一個開放協議，它對應用程序如何為大型語言模型（LLMs）提供上下文進行了標準化。這使得像 Claude 這樣的 LLMs 能夠以安全且標準的方式與外部系統和數據源進行交互。

MCP 就如同 AI 應用程序的 USB - C 端口，它通過一種標準方式將 AI 模型連接到不同的數據源和工具。本項目實現了一個遵循 MCP 規範的 Spotify 服務器，從而讓 AI 助手能夠控制並與其 Spotify 賬戶進行交互。

📦 安裝指南

先決條件

1. Go 1.18 或更高版本
2. 一個 Spotify 賬戶（需要 Spotify Premium 才能進行播放控制）
3. Spotify 開發者憑證

獲取 Spotify API 憑證

1. 訪問 Spotify 開發者儀表板
2. 使用您的 Spotify 賬戶登錄
3. 點擊“創建應用”
4. 填寫應用程序名稱和描述
5. 創建完成後，您將看到您的 客戶端 ID，並可以查看您的 客戶端密鑰
6. 將重定向 URI 設置為 http://127.0.0.1:1690/callback

與 Claude 使用

要使用此服務器與 Claude for Desktop，可按以下步驟操作：

1. 打開 Claude for Desktop
2. 創建或更新您的 MCP 配置文件，文件位置如下：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
3. 添加以下配置：

{
  "mcpServers": {
    "spotify": {
      "command": "/path/to/spotify-mcp-binary",
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

4. 重新啟動 Claude for Desktop
5. 第一次使用 Spotify 工具時，您需要通過 spotify_login 工具進行身份驗證

💻 使用示例

可用工具

播放控制

• spotify_login - 開始 Spotify 身份驗證流程以獲取播放控制權限
• play - 在您的 Spotify 賬戶上開始或恢復播放
• pause - 暫停您的 Spotify 賬戶上的播放
• next_track - 跳到當前播放隊列中的下一首曲目
• previous_track - 跳到當前播放隊列中的上一首曲目
• shuffle - 切換您的 Spotify 賬戶上的隨機播放模式
• current_track - 獲取正在播放的曲目的信息
• get_queue - 獲取當前播放隊列
• get_current_playlist - 獲取當前正在播放的播放列表

播放列表管理

• create_playlist - 創建新的播放列表
• add_to_playlist - 將曲目添加到播放列表中
• remove_from_playlist - 從播放列表中刪除曲目
• delete_playlist - 刪除播放列表
• get_playlists - 獲取所有可用播放列表

📄 許可證

該項目的源代碼遵循 MIT License。