Melody MCP Server

旋律MCP音乐服务器

一种模型上下文协议（MCP）服务器，它公开Spotify播放控件、播放列表生成、音乐发现和网络搜索工具，以与大型语言模型集成。

特性

🔐 内置身份验证

• 基于浏览器登录的自动Spotify OAuth流
• 安全的令牌管理和刷新
• 无需手动处理令牌

Spotify播放控制

• 播放特定曲目
• 暂停/恢复播放
• 跳过曲目（下一个/上一个）
• 控制体
• 管理播放队列
• 获取当前播放的曲目
• 设备管理

播放列表管理

• 使用AI根据提示创建播放列表
• 根据收听历史生成播放列表
• 从提供的曲目或艺术家创建播放列表
• 搜索曲目和艺术家（无需身份验证）

音乐探索

• 使用Last.fm API进行智能音乐搜索
• 按流派/标签获取热门曲目
• 查找相似的艺术家和曲目
• 获取艺术家热门曲目

网页搜索

• 与音乐相关查询的Google自定义搜索集成

快速开始

1. 安装依赖项：

npm install

1. 配置环境变量：

cp env.example .env
# Edit .env with your API keys

1. 启动服务器：

npm start

1. 使用Spotify进行身份验证（当克劳德提示时）：

- 使用 spotify_authenticate 工具 - 浏览器将自动打开Spotify登录 - 完成OAuth流程 - 返回Claude Desktop以使用播放功能

身份验证流程

MCP服务器包括一个内置的身份验证系统：

1. 检查身份验证状态：

   Use: spotify_check_auth

1. 登录Spotify：

   Use: spotify_authenticate

- 自动打开浏览器 - 完成Spotify OAuth - 自动管理的代币

1. 注销：

   Use: spotify_logout

工具类别

🔐 身份验证工具（3个工具）

• spotify_authenticate -登录Spotify
• spotify_check_auth -检查身份验证状态
• spotify_logout -退出Spotify

🎵 播放控制（11个工具-需要身份验证）

• spotify_play_track -播放特定曲目
• spotify_pause/resume -控制播放
• spotify_skip_next/previous -轨迹导航
• spotify_set_volume -音量控制
• spotify_add_to_queue -队列管理
• spotify_get_currently_playing -当前曲目信息
• spotify_get_devices -设备管理
• spotify_transfer_playback -开关设备
• spotify_seek -位置控制

🔍 搜索工具（2个工具-无需身份验证）

• spotify_search_track -查找曲目
• spotify_search_artist -寻找艺术家

📝 播放列表生成（3个工具）

• playlist_create_from_prompt -由文本生成的AI
• playlist_create_from_tracks -基于提供的轨迹
• playlist_create_from_artists -基于提供的艺术家

🎼 音乐探索（4个工具）

• music_discovery_search -智能Last.fm搜索
• music_discovery_by_genre -基于类型的发现
• music_discovery_similar_artist -寻找相似的艺术家
• music_discovery_artist_top_tracks -艺术家的流行歌曲

🌐 网络搜索（1个工具）

• web_search -Google自定义搜索集成

总计：24个工具

配置

创建一个 .env 根目录中的文件，包含以下变量：

# Spotify API Credentials
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret

# Last.fm API (for music discovery)
LASTFM_API_KEY=your_lastfm_api_key

# Google Search API (for web search)
GOOGLE_SEARCH_API_KEY=your_google_search_api_key
GOOGLE_SEARCH_CX_ID=your_google_search_cx_id

# OpenAI API Key (for playlist generation)
OPENAI_API_KEY=your_openai_api_key

获取API密钥

Spotify API

1. 首选 Spotify开发者仪表板
2. 创建新应用程序
3. 复制客户端ID和客户端密码

最后.fm API

1. 首选 最后.fm API
2. 创建API帐户
3. 复制API密钥

谷歌自定义搜索API

1. 首选 谷歌云控制台
2. 启用自定义搜索API
3. 创建凭据并复制API密钥
4. 在以下位置设置自定义搜索引擎 自定义搜索引擎

OpenAI API

1. 首选 OpenAI平台
2. 创建API密钥

与MCP客户端一起使用

此服务器可以与任何兼容MCP的客户端集成。服务器公开了以下工具：

• spotify_play_track -播放特定曲目
• spotify_pause -暂停播放
• spotify_resume -恢复播放
• spotify_skip_next -跳到下一首曲目
• spotify_skip_previous -跳至上一曲目
• spotify_set_volume -设置播放音量
• spotify_add_to_queue -将曲目添加到队列
• spotify_get_currently_playing -获取当前曲目信息
• spotify_search_track -搜索曲目
• spotify_search_artist -寻找艺术家
• playlist_create_from_prompt -从文本提示生成播放列表
• playlist_create_from_tracks -从提供的曲目创建播放列表
• playlist_create_from_artists -从提供的艺术家创建播放列表
• music_discovery_search -智能音乐搜索
• music_discovery_by_genre -按流派获取曲目
• music_discovery_similar_artist -寻找相似的艺术家
• music_discovery_artist_top_tracks -获取艺术家的热门曲目
• web_search -执行网络搜索

认证

对于Spotify功能，您需要提供有效的Spotify访问令牌。服务器希望将此作为参数传递给Spotify相关工具。

许可证

麻省理工学院