Spotify MCP Server

🚀 Spotify-MCP MCP 服務器

Spotify-MCP MCP 服務器項目致力於將 Claude 與 Spotify 相連接，藉助 spotipy-dev 的 API 來實現相關功能。

✨ 主要特性

• 可對播放操作進行開始、暫停和跳過。
• 能夠搜索曲目、專輯、藝術家以及播放列表。
• 可以獲取曲目、專輯、藝術家或播放列表的詳細信息。
• 支持對 Spotify 隊列進行管理。

📺 演示

請確保打開音頻。

📦 安裝指南

獲取 Spotify API 密鑰

你需要在 developer.spotify.com 創建一個賬戶，接著導航到 控制檯。創建一個應用，並將重定向 URI 設置為 http://localhost:8888 （你可以選擇任何端口，但必須使用 http 和 localhost）。同時，將“使用的 API”設置為“Web Playback SDK”。

在本地運行此項目

此項目尚未配置用於臨時環境（例如 uvx 使用），你可以通過克隆此倉庫在本地運行該項目：

git clone https://github.com/varunneal/spotify-mcp.git

將此工具添加為 MCP 服務器：

• 在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

配置內容如下：

"spotify": {
    "command": "uv",
    "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
    ],
    "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
}

故障排除

若無法使此 MCP 正常運行，請打開問題。以下是一些有用的提示：

1. 確保 uv 已更新，建議使用版本 >=0.54。
2. 確保 Claude 對項目有執行權限，可使用命令 chmod -R 755。
3. 確保你擁有 Spotify 高級會員（運行開發者 API 所需）。

此 MCP 將向標準錯誤輸出日誌（按 MCP 規格指定）。在 Mac 上，Claude Desktop 應用會將這些日誌發送到 ~/Library/Logs/Claude；在其他平臺上 你可以在這裡找到日誌。

你可以通過 npm 使用 Inspector 發射此 MCP：

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

啟動後，Inspector 會在瀏覽器中顯示一個 URL，以便你開始調試。

📋 待辦事項

很遺憾，由於 Spotify API 已經棄用了很多酷功能，請參閱 此處。未來的改進方向如下：

• 添加測試。
• 新增對更多 Spotify API 的支持。
• 提高代碼的可維護性和文檔質量。

🚀 發佈和構建

請參考後續內容。