Spotify MCP

🚀 Spotify-MCP 服務器項目

本項目致力於將Claude與Spotify進行連接，藉助spotipy-dev的API構建，為用戶提供便捷的音樂控制與管理體驗。

✨ 主要特性

• 🎵 控制播放：可輕鬆實現音樂的開始、暫停和跳過播放操作。
• 🔍 搜索功能：支持搜索歌曲、專輯、藝術家或播放列表。
• ℹ️ 信息獲取：能夠獲取關於歌曲、專輯、藝術家或播放列表的詳細信息。
• 📋 隊列管理：方便管理Spotify的播放隊列。

🎥 演示

請確保音頻已開啟哦~

📦 安裝指南

獲取Spotify API密鑰

您需要在developer.spotify.com創建一個賬戶，然後導航到儀表盤。接著創建一個應用，並將redirect_uri設置為http://localhost:8888 （您可以選擇任何端口，但必須使用http和localhost）。這裡我選擇了"APIs used"設為"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": 您的_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": 您的_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
}

故障排除

如果無法使用此MCP，請打開問題。以下是一些實用提示：

1. 確保uv已更新，建議版本>=0.54。
2. 確保Claude有執行權限，可使用命令：chmod -R 755。
3. 確保您擁有Spotify Premium（運行開發者API所需的條件）。

此MCP將輸出到標準錯誤流（如MCP規範中所指定的）。在Mac上，Claude Desktop應用程序會在~/Library/Logs/Claude路徑下顯示日誌；在其他平臺上，可以在此處找到日誌。

📅 待辦事項

很遺憾，由於Spotify API的一些功能已被停用，現在有大量酷炫的功能無法實現。後續將主要關注對項目的健康發展：

• 🧪 添加測試。
• 📃 為管理播放列表添加API支持。
• ⏭️ 為搜索結果、播放列表/專輯等的分頁添加API支持。

歡迎提交拉取請求！

🚀 部署

打包與發佈

準備發行版本的步驟如下：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建發行版本：

uv build

這將在dist/目錄下創建源代碼和輪格式分發。 3. 發佈到PyPI：

uv publish

注意：您需要通過環境變量或命令行參數設置PyPI憑證：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD

調試

由於MCP服務器通過標準I/O運行，調試可能具有挑戰性。為了獲得最佳的調試體驗，我們強烈推薦使用MCP Inspector。 您可以通過以下命令啟動MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

啟動後，Inspector會顯示一個URL，您可以在瀏覽器中訪問該URL以開始調試。