Spotify音乐管理服务器

标题：Spotify MCP服务器 表情符号🎵 颜色来源：蓝色 颜色To：紫色 sdk：毕业 sdk版本：5.33.1 app_file:server.py 固定：false

Spotify MCP服务器

基于Gradio的MCP服务器，提供用户友好的界面与Spotify的API进行交互。此服务器提供各种工具来管理您的Spotify体验，从身份验证到播放列表管理和音乐播放控制。

演示视频

观看演示视频

特性

• 认证：使用OAuth2进行安全的Spotify身份验证
• 音乐搜索：搜索曲目并获取艺术家信息
• 队列管理：将歌曲添加到您的Spotify队列中（需要Spotify Premium）
• 最近播放：查看您最近播放的曲目
• 播放列表管理:
  • 创建新播放列表
  • 查看现有播放列表
  • 将歌曲添加到播放列表
• 用户洞察:
  • 查看顶级艺术家
  • 查看热门曲目
  • 获取流派信息

需求

• Python 3.x
• Spotify Premium帐户（某些队列管理功能需要）
• Spotify开发者帐户API证书

设置

1. 克隆此存储库
2. 安装所需的依赖项：
   复制

   pip install gradio spotipy
   

配置

获取Spotify API密钥

1. 在上创建帐户 developer.spotify.com
2. 导航到仪表板
3. 使用以下设置创建新应用程序：
   • 重定向URI: http://127.0.0.1:5000/callback （您可以选择任何端口，但必须使用http和显式的环回地址）
   • 注意：您可能需要重新启动MCP环境（例如Claude Desktop）一两次才能正常工作

环境变量

服务器使用以下环境变量： 请使用凭据创建.env文件

• CLIENT_ID：您的Spotify API客户端ID
• CLIENT_SECRET：您的Spotify API客户秘密
• REDIRECT_URI您的 Spotify API 重定向 URI (默认:http://127.0.0.1:5000/callback ）

本地运行

此项目旨在本地运行，尚未针对临时环境（例如uvx使用）进行设置。要运行：

1. 克隆此存储库
2. 设置环境变量
3. 运行服务器

Claude Desktop查询示例

在Claude Desktop中尝试以下示例查询以探索不同的功能：

音乐发现与分析

“向我展示过去6个月我的前10位艺术家及其流派”

智能播放列表创建

“创建我本月前20首曲目的播放列表”

队列管理

“搜索“我更喜欢我”并将其添加到我的队列中”

播放列表组织

“显示我的所有播放列表”

音乐策划

“将我本月的前10首曲目与我最喜欢的曲目进行比较”

快捷操作

“显示我最近播放的5首歌曲”

API终点

服务器通过Gradio接口公开了几个端点：

• add_to_queue_song：将歌曲添加到队列中（需要付费）
• get_artist_and_track：搜索曲目
• auth_with_spotify：通过Spotify进行身份验证
• get_recently_played_songs：获取最近播放的曲目
• create_playlist：创建新的播放列表
• get_playlist_name_and_id：获取播放列表信息
• add_songs_to_playlist：将歌曲添加到播放列表
• get_users_top_artists：获取用户的顶级艺术家
• get_user_top_tracks：获取用户的热门曲目

高级功能

以下功能需要Spotify Premium帐户：

• 将歌曲添加到队列

Claude桌面配置

要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的设置中（端口号可能会有所不同，请检查）：

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:7860/gradio_api/mcp/sse"]
    }
  }
}

此配置允许Claude Desktop连接到在端口7860上运行的Gradio MCP服务器。

标签

mcp服务器轨道