MCP Spotify

🚀 Spotify MCP 工具

這是一款便捷快速的 Spotify MCP（機器控制協議）工具，藉助它，你可以通過 Cursor 輕鬆控制 Spotify 播放器，實現播放、暫停、搜索等一系列操作，為你的音樂體驗增添更多便利。

🚀 快速開始

演示

點擊以下鏈接查看演示：演示鏈接

先決條件

• uv
• Spotify API

📦 安裝指南

1. 克隆此倉庫。
2. 在倉庫根目錄中創建一個 .env 文件，並添加您的 Spotify API 憑證（從 .env.example 複製）。您可以在 Spotify 開發者儀表盤 創建應用後獲取這些憑證。
3. 前往 Cursor 設置 > 功能 > MCP 服務器 > + 添加新的 MCP 服務器。
   • 名稱：Spotify
   • 類型：命令
   • 命令：uv --directory <倉庫路徑/mcp-spotify> run main.py

安裝成功後，您將看到如下界面：

試用方法

打開 Composer 以“代理”模式，並啟動，即可通過 Cursor 控制您的 Spotify 播放器（請確保 Spotify 正在活躍設備上運行）。

✨ 主要特性

💻 使用示例

以下是通過 Cursor Composer 與 Spotify MCP 工具交互的示例對話：

1. 用戶: "顯示我的播放列表。"
   響應: "這是您的播放列表：輕鬆 vibes, Workout Mix, Top Hits."
2. 用戶: "播放我的'Chill Vibes'播放列表。"
3. 用戶: "暫停歌曲。"
   響應: "播放已暫停。"
4. 用戶: "恢復播放。"
   響應: "正在繼續播放..."
5. 用戶: "這是什麼歌？"
   響應: "您正在收聽'Faded' by Alan Walker。"
6. 用戶: "告訴我這個藝術家的信息並顯示一些熱門曲目。"
   響應: "藝術家信息：Alan Walker。"
7. 用戶: "顯示我過去 6 個月內的最常聽的藝術家。"
   響應: "以下是您最常收聽的藝術家..."
8. 用戶: "搜索 Coldplay。"
   響應: "找到藝術家：Coldplay。以下是他們的熱門曲目..."
9. 用戶: "播放'Fix You'這首歌。"
   響應: "開始播放'Fix You'..."
10. 用戶: "顯示我的隊列。"
    響應: "當前隊列：Track 1, Track 2, Track 3..."
11. 用戶: "將'Paradise'添加到我的隊列中。"
    響應: "已將'Paradise' by Coldplay 添加到您的隊列中。"
12. 用戶: "將'Paradise'提前到隊列中的位置。"
13. 用戶: "設置為循環播放。"
14. 用戶: "我喜歡這首歌，推薦一些類似的歌曲。"
    響應: "基於這首歌曲的推薦曲目在此..."
15. 用戶: "將此曲添加到我的'Chill Vibes'播放列表中。"

額外可用功能

• 移動到歌曲的特定位置
• 查看詳細的播放狀態
• 跳過多首歌曲

如果您希望支持更多功能，請隨時提出問題！