Splunk MCP Q0y

🚀 Spotify MCP 服務器

本項目是一個用於 Spotify 集成的 Model Context Protocol (MCP) 服務器，它能讓像 Claude 這類 AI 助手對您的 Spotify 賬戶進行控制與交互，為音樂管理帶來全新體驗。

🚀 快速開始

本項目提供了一組 MCP 工具，賦予 AI 助手強大的音樂管理能力：

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

它基於 Model Context Protocol 和 zmb3/spotify Golang SDK 構建。

✨ 主要特性

什麼是 MCP？

Model Context Protocol (MCP) 是一個開放協議，它為大型語言模型（LLMs）與外部系統和數據源的交互提供了標準化的上下文。就像 USB - C 端口為電子設備提供標準連接方式一樣，MCP 為 AI 應用提供了一種標準化方式，讓 LLMs 如 Claude 能以安全且規範的方式與不同數據源和工具連接。本項目實現了一個符合 MCP 規範的 Spotify 服務器，使 AI 助手可以控制和交互您的 Spotify 賬戶。

📦 安裝指南

先決條件

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

獲取 Spotify API 憑證

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

與 Claude 使用

要與 Claude Desktop 一起使用此服務器：

1. 打開 Claude 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 Desktop
5. 第一次使用 Spotify 工具時，您需要通過 spotify_login 工具進行身份驗證

💻 使用示例

可用工具

Playback（播放）

• spotify_login - 開始 Spotify 身份驗證過程以控制 playback
• play - 在您的 Spotify 賬戶上開始或恢復 playback
• pause - 暫停您的 Spotify 賬戶上的 playback
• next_track - 跳到當前播放隊列中的下一曲
• previous_track - 跳到當前播放隊列中的前一曲
• shuffle - 切換您的 Spotify 賬戶的 shuffle 模式
• current_track - 獲取當前正在播放的曲目的信息
• get_queue - 獲取當前 playback 隊列
• add_tracks_to_queue - 將曲目添加到當前 playback 隊列

Playlist（播放列表）

• get_playlist - 獲取特定播放列表的詳細信息
• get_playlist_tracks - 獲取播放列表中的曲目
• create_playlist - 創建新的 Spotify 播放列表
• add_tracks_to_playlist - 向播放列表添加曲目
• remove_tracks_from_playlist - 從播放列表中移除曲目
• get_user_playlists - 獲取用戶的所有播放列表

📄 許可證

該項目採用 MIT License，詳情請訪問 MIT License。

🤝 貢獻指南

如果您希望為該項目做出貢獻，請參考我們的 Contributing Guide，瞭解如何參與項目。