AI导哈

音乐控制工具

Zoe Music MCP是一个通过REST API为AI助手提供音乐控制功能的服务器工具，支持播放、暂停、音量调节等操作。

  • by MarkMolina
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 MarkMolina/zoe-music-mcp

使用说明

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

相关 MCP