splunk-mcp

Spotify MCP 服务

用于集成 Spotify 的模型上下文协议（MCP）服务，可让 Claude 等 AI 助手控制并与您的 Spotify 账户交互。

概述

本项目提供了一组 MCP 工具，使 AI 助手能够：

• 搜索播放列表
• 获取播放列表详情和曲目
• 控制播放（播放、暂停、跳过、上一首）
• 创建和修改播放列表
• 切换随机播放模式
• 查看当前播放的曲目
• 将曲目添加到队列

基于 Model Context Protocol 和 zmb3/spotify Golang SDK 构建。

什么是 MCP？

模型上下文协议（MCP）是一种开放协议，用于规范应用程序向大语言模型（LLM）提供上下文的方式。它支持 Claude 等 LLM 以安全且标准化的方式与外部系统和数据源交互。

MCP 就像 AI 应用的 USB-C 接口，提供连接 AI 模型与不同数据源和工具的标准化方式。本项目实现了一个遵循 MCP 规范的 Spotify 服务，让 AI 助手能够控制并与您的 Spotify 账户交互。

设置

先决条件

1. Go 1.18 或更高版本
2. Spotify 账户（您需要 Spotify Premium 才能控制播放）
3. Spotify 开发者凭据

获取 Spotify API 凭据

1. 访问 Spotify Developer Dashboard
2. 使用您的 Spotify 账户登录
3. 点击“Create an App”
4. 填写应用名称和描述
5. 创建完成后，您将看到 Client ID，并可查看 Client Secret
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 - 跳到 Spotify 队列中的下一首曲目
• previous_track - 跳到 Spotify 队列中的上一首曲目
• shuffle - 切换您的 Spotify 账户上的随机播放模式
• current_track - 获取当前播放曲目的信息
• get_queue - 获取当前播放队列
• add_tracks_to_queue - 将曲目添加到当前播放队列

播放列表

• get_playlist - 获取指定播放列表的详细信息
• get_playlist_tracks - 获取播放列表中的曲目
• create_playlist - 创建新的 Spotify 播放列表
• add_tracks_to_playlist - 将曲目添加到播放列表
• remove_tracks_from_playlist - 从播放列表中移除曲目
• get_user_playlists - 获取 Spotify 用户的播放列表

搜索

• simple_playlist_and_album_search - 按名称搜索播放列表或专辑
• simple_song_search - 按名称搜索歌曲

许可证

MIT License

致谢

• 使用 zmb3/spotify Golang SDK 构建
• 实现了 Model Context Protocol
• 灵感来自不断发展的 MCP 服务生态系统

贡献

欢迎贡献！请随时提交 Pull Request。