小智音乐
hst6666/xiao
Hosted
0 Stars
18 次浏览
更新于 2026-08-23
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"xiaozhi-music-mcp": {
"args": [
"xiaozhi-music-mcp"
],
"command": "uvx"
}
}
}可用工具 （13 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
search_music 2 个参数 需填 1 项
搜索音乐（网易云音乐源），支持按歌曲名、歌手名搜索
必填参数：query
play_music 4 个参数
播放音乐，返回真实播放地址。提供 query（歌名/歌手）自动搜索并播放第一首，或提供 song_id 精确播放
该工具无需必填参数，直接调用即可
get_music_url 1 个参数 需填 1 项
获取指定歌曲的播放地址
必填参数：song_id
get_lyrics 1 个参数 需填 1 项
获取指定歌曲的LRC歌词
必填参数：song_id
pause_music
暂停当前播放的音乐
该工具无需必填参数，直接调用即可
resume_music
继续播放已暂停的音乐
该工具无需必填参数，直接调用即可
stop_music
停止播放音乐
该工具无需必填参数，直接调用即可
set_volume 1 个参数 需填 1 项
设置音乐播放音量
必填参数：volume
add_to_playlist 3 个参数 需填 1 项
将歌曲添加到播放列表
必填参数：song_id
get_playlist
获取当前播放列表
该工具无需必填参数，直接调用即可
clear_playlist
清空播放列表
该工具无需必填参数，直接调用即可
next_song
播放下一首歌
该工具无需必填参数，直接调用即可
previous_song
播放上一首歌
该工具无需必填参数，直接调用即可
服务介绍
我基于它的工具逻辑重写了完整包，零依赖、标准 MCP 2024-11-05：
C:\Users\Administrator\AppData\Local\hermes\workspace\xiaozhi-music-mcp-pypi\
├── pyproject.toml
├── README.md
├── src\xiaozhi_music_mcp\server.py # 11 个音乐工具 + initialize/tools/resources 全套
└── dist\xiaozhi_music_mcp-1.0.0-py3-none-any.whl
**② 魔搭创建 MCP 服务**：MCP 广场 → 右上角"创建MCP" → **自定义创建** → 服务配置（JSON）填：
```json
{
"mcpServers": {
"xiaozhi-music-mcp": {
"command": "uvx",
"args": ["xiaozhi-music-mcp"]
}
}
}
安装命令选 UVX，托管类型选 "可托管部署"。等自动部署检测通过（验证到 list_tools），服务会打上"可部署/hosted"标签。
③ 小智控制台接入：在智控台的 MCP 工具/接入点管理里，添加魔搭 hosted 服务给你的连接地址（streamable_http 形式）。设备端走你那个 wss://api.xiaozhi.me/mcp/?token=… 接入点即可，然后对小智说"搜索周杰伦的歌"测试。
