📦 Xiaozhi Mcp Music Official — 小智音乐播放

v1.0.0

通过 MCP 协议为小智增加在线音乐搜索、播放、暂停、继续、停止等控制能力，支持多源 fallback 并调用本地播放器播放网络音频。

0· 114·0 当前·0 累计

by @joe12801

API工具自动化网络工具云服务智能体

下载技能包

最后更新

2026/3/25

安全扫描

VirusTotal

无害

查看报告

OpenClaw

可疑

high confidence

该技能基本实现了描述功能（将 MCP 端点桥接到本地播放器及音乐 API），但元数据与声明需求不一致，代码调用外部第三方 API 且依赖未列出的环境密钥，存在凭证泄露与信任风险。

评估建议

此技能实现本地 MCP 到播放器的音乐桥接，将：1) 连接你提供的 MCP_ENDPOINT websocket；2) 使用你的 MUSIC_API_KEY 调用第三方音乐 API（api-v2.yuafeng.cn）；3) 默认启动本地 mpv 播放器并用 pkill 控制。安装前：仅连接可信 MCP 端点；确认 api-v2.yuafeng.cn 为预期音乐 API 提供方；手动补全遗漏的环境变量；在沙箱/容器内运行并审计第三方 API URL 与 fastmcp 依赖。...

详细分析 ▾

ℹ 用途与能力

代码实现了与描述一致的 MCP 音乐桥接（websocket MCP 端点 → 桥接 → 音乐 API → 本地播放器）。但包/注册元数据未声明所需环境变量，而代码实际依赖 MCP_ENDPOINT 与 MUSIC_API_KEY 等，存在声明与实际需求不符的问题。

✓ 指令范围

SKILL.md 说明与代码一致：提示用户设置环境变量、安装依赖并运行桥接。未要求读取无关文件或凭证。运行时需连接外部 MCP 端点并调用第三方音乐 API，用户需信任这些远程服务。

✓ 安装机制

无特殊安装器；用户按说明 pip install 随技能附带的 requirements.txt。未出现任意下载或基于 URL 的安装器。

⚠ 凭证需求

代码需要 MCP_ENDPOINT 与 MUSIC_API_KEY（并可能将 MUSIC_API_KEY 作为 apikey 参数发送至 api-v2.yuafeng.cn）。注册元数据错误地未列出任何必需环境变量/凭证。虽然需要 API 密钥并连接远程 websocket 对音乐桥接而言合理，但元数据遗漏及密钥被发送至第三方域名构成显著风险——用户可能意外将 API 密钥泄露至非预期主机。PLAYER_CMD 与 MUSIC_SOURCE 亦从环境读取，但未在元数据中声明。

✓ 持久化与权限

技能非常驻启用，采用普通自主调用。不尝试修改其他技能或系统级配置。为本地播放控制会启动本地进程（播放器、pkill/暂停/恢复），运行时权限限于用户进程所有权限。

安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/3/25

首次发布：官方风格的小智 MCP 在线音乐桥接，支持在线搜索、fallback 及本地播放器播放。

● 无害

安装命令

点击复制

官方npx clawhub@latest install xiaozhi-mcp-music-official

镜像加速npx clawhub@latest install xiaozhi-mcp-music-official --registry https://cn.longxiaskill.com

技能文档

# xiaozhi-mcp-music-official 简体中文 | English --- ## 简体中文 ### 作用这是一个最小可用的 小智在线音乐 MCP 原型，按小智官方 MCP 接入方式设计。 ### 架构 ``text 小智 → MCP 接入点 → mcp_pipe.py → music_mcp.py → 在线音乐 API → 本地播放器（mpv） → 返回结果给小智 ` ### 提供的工具 - play_music(query) - play_music_index(query, n) - stop_music() - pause_music() - resume_music() - next_track() - set_volume(level) - music_info() ### 当前方案说明 - 当前接入在线点歌 API - 支持多源 fallback（优先 kuwo） - 优先尝试从 API 返回中提取可播放直链 - 用 mpv 直接播放在线 URL - 如果没有可播放链接，就把歌曲信息返回给小智 ### 启动 `bash pip install -r requirements.txt cp .env.example .env python3 mcp_pipe.py music_mcp.py ` ### 环境变量 - MCP_ENDPOINT：小智 MCP 接入点 - MUSIC_API_KEY：音乐 API key - MUSIC_SOURCE：默认优先源，建议 kuwo - PLAYER_CMD：播放器命令，默认 mpv ### 注意事项 - 如果服务器里没有安装 mpv，播放会失败，但搜歌和返回信息仍然可用。 - 当前是最小原型，后续还可以升级成播放列表、上一首/下一首、音量精控、多平台音乐源版本。 --- ## English ### Purpose This is a minimal working XiaoZhi online music MCP prototype, designed following XiaoZhi's official MCP integration style. ### Architecture `text XiaoZhi → MCP endpoint → mcp_pipe.py → music_mcp.py → online music API → local player (mpv) → return result to XiaoZhi ` ### Provided tools - play_music(query) - play_music_index(query, n) - stop_music() - pause_music() - resume_music() - next_track() - set_volume(level) - music_info() ### Current approach - Uses an online music API - Supports multi-source fallback (prefers kuwo) - Tries to extract a playable direct link first - Uses mpv to play network audio URLs - If no playable URL is returned, it reports the matched song info back to XiaoZhi ### Start `bash pip install -r requirements.txt cp .env.example .env python3 mcp_pipe.py music_mcp.py ` ### Environment variables - MCP_ENDPOINT: XiaoZhi MCP endpoint - MUSIC_API_KEY: music API key - MUSIC_SOURCE: preferred source, recommended kuwo - PLAYER_CMD: player command, default mpv ### Notes - If mpv` is not installed on the server, playback will fail, but search/info retrieval will still work. - This is a minimal prototype and can later be extended with playlists, previous/next track, fine-grained volume control, and richer music sources.

数据来源：ClawHub ↗ · 中文优化：龙虾技能库