使用说明
音乐MCP服务器🎵
使用模型上下文协议（MCP）直接从GitHub Copilot Chat控制Spotify播放。
特性
- ▶️ 播放控制：播放、暂停、跳过、上一首曲目
- 🎵 正在播放：查看当前播放的内容
- 📋 播放列表管理：创建、编辑和管理播放列表
- 🔄 设备控制：在设备之间传输播放
- 🔍 搜索：查找和播放曲目
安装
pip install music-mcp-server
快速开始
1.运行安装程序（一次性）
music-mcp-setup
这将指导您完成：
- 创建Spotify开发者应用程序
- 授权MCP服务器
- 安全地保存您的凭据
2.添加到您的MCP客户端
将此添加到您的MCP设置中（例如。， ~/.config/github-copilot/mcp.json):
{
"mcpServers": {
"music": {
"command": "music-mcp-server"
}
}
}
3.与Copilot聊天一起使用
现在，您可以从Copilot Chat控制Spotify：
- “现在在玩什么？”
- “播放下一首曲目”
- “搜索泰勒·斯威夫特的歌曲”
- “创建一个名为“Coding Vibes”的播放列表”
可用命令
| 命令 | 描述 |
|---|---|
play_music |
恢复播放 |
pause_music |
暂停播放 |
next_track |
跳到下一首曲目 |
previous_track |
转到上一曲目 |
current_track |
显示正在播放 |
search_tracks |
搜索歌曲 |
play_track |
播放特定曲目 |
get_devices |
列出可用设备 |
transfer_playback |
切换播放设备 |
get_playlists |
列出您的播放列表 |
create_playlist |
创建新播放列表 |
add_to_playlist |
将曲目添加到播放列表 |
remove_from_playlist |
从播放列表中删除曲目 |
get_playlist_tracks |
查看播放列表曲目 |
delete_playlist |
删除播放列表 |
需求
- Python 3.10+
- Spotify Premium帐户（播放控制所需）
- Spotify开发者帐户（免费）
故障排除
“找不到凭据”
跑 music-mcp-setup 配置您的Spotify凭据。
“未找到设备”
确保Spotify已打开，并在至少一台设备上播放。
“需要保费”
播放控制功能需要Spotify Premium。
发展
# Clone the repo
git clone https://github.com/jower999/music-mcp-server.git
cd music-mcp-server
# Create virtual environment
python3.12 -m venv venv
source venv/bin/activate
# Install in development mode
pip install -e .
# Run setup
music-mcp-setup
# Test with MCP Inspector
mcp dev music_mcp_server/server.py
许可证
麻省理工学院