AI导哈

Spotify MCP服务器

一个用于Spotify集成的模型上下文协议（MCP）服务器，允许AI助手控制并交互您的Spotify账户。

  • by NathanPr03
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 nathanpr03/spotify-mcp

使用说明

Spotify MCP服务器

用于Spotify集成的模型上下文协议（MCP）服务器，允许像Claude这样的人工智能助手控制您的Spotify帐户并与之交互。

概述

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

  • 搜索播放列表
  • 检索播放列表详细信息和曲目
  • 控制播放（播放、暂停、跳过、上一页）
  • 创建和修改播放列表
  • 切换洗牌模式
  • 查看当前播放的曲目
  • 将曲目添加到队列中

建在 模型上下文协议 和 zmb3/spotify Golang SDK。

什么是MCP？

模型上下文协议（MCP）是一个开放协议，它规范了应用程序如何向大型语言模型（LLM）提供上下文。它允许像Claude这样的LLM以安全和标准化的方式与外部系统和数据源进行交互。

MCP的工作原理类似于AI应用程序的USB-C端口，提供了一种将AI模型连接到不同数据源和工具的标准化方法。该项目实现了一个遵循MCP规范的Spotify服务器，使AI助手能够控制您的Spotify帐户并与之交互。

设置

先决条件

  1. 上涨1.18或更高
  2. Spotify帐户（您需要Spotify Premium才能进行播放控制）
  3. Spotify开发者证书

获取Spotify API证书

  1. 访问 Spotify开发者仪表板
  2. 使用您的Spotify帐户登录
  3. 点击“创建应用程序”
  4. 填写应用程序名称和描述
  5. 创建后，您将看到您的 客户端ID 您可以查看您的 客户端密钥
  6. 将重定向URI设置为 http://127.0.0.1:1690/callback

与克劳德一起使用

要将此服务器与Claude for Desktop一起使用，请执行以下操作：

  1. 打开Claude桌面版

  2. 在以下位置创建或更新MCP配置：

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %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"
      }
    }
  }
}
  1. 重新启动桌面版的Claude
  2. 首次使用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许可证

致谢

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP