Zoe音乐MCP
MCP服务器公开 Zoe音乐控制 REST API作为人工智能助手的工具。
工具
| 工具 | 说明 |
|---|---|
get_now_playing | 当前曲目、艺术家、专辑、进度 |
play_music | 播放URI或继续播放 |
pause_music | 暂停播放 |
skip_track | 下一曲目 |
previous_track | 上一曲目 |
set_volume | 设置扬声器组音量（0-100） |
list_speakers | 列出发言者组和状态 |
activate_speakers | 激活扬声器组 |
deactivate_speakers | 停止并停用组 |
get_queue | 当前播放队列 |
add_to_queue | 将曲目添加到队列 |
clear_queue | 清空队列并停车 |
search_music | 按姓名/艺术家/专辑搜索曲目 |
get_playlists | 用户的Spotify播放列表 |
get_playlist_tracks | 播放列表中的曲目 |
get_recently_played | 最近播放的曲目 |
get_status | 系统健康检查 |
设置
pip install --index-url https://pypi.org/simple/ -e .用法
克劳德代码
claude mcp add zoe-music -- python /path/to/zoe-music-mcp/server.py或在 ~/.claude/settings.json:
{
"mcpServers": {
"zoe-music": {
"command": "python",
"args": ["/path/to/zoe-music-mcp/server.py"],
"env": {
"ZOE_MUSIC_URL": "https://audio.markmolina.nl:8443"
}
}
}
}环境
| 变量 | 默认值 | 描述 |
|---|---|---|
ZOE_MUSIC_URL | https://audio.markmolina.nl:8443 | Zoe音乐控制API的基本URL |
建筑
AI Assistant (Claude, Zoe, etc.)
|
| stdio (MCP protocol)
|
v
zoe-music-mcp (this server)
|
| HTTPS
|
v
Zoe Music Control API (Pi @ audio.markmolina.nl:8443)
|
v
Music Assistant -> AirPlay 2 Speakers