sonos_mcp
通过自然语言指令控制 Sonos 音箱的智能体工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：sonos_mcp。 它的用途是：通过自然语言指令控制 Sonos 音箱的智能体工具。 完整的 Skill 内容见：https://321skill.com/skills/sonos-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我想在客厅播放一些尼尔·杨的现场版歌曲，并把音量调到50%。’ 它会自动搜索相关曲目，将其加入客厅主音箱的播放队列，并精确设置音量。或者
对AI说：‘把当前播放的这首歌加到我的‘跑步歌单’里。’ 它会识别当前曲目信息，并将其添加到指定的本地或Sonos歌单中。
介绍
Sonos MCP 是一个结合了 Claude Agent SDK 和 SoCo Python 包的智能体工具，旨在解决用户需要通过复杂界面或手动操作来控制 Sonos 音箱系统的问题。它允许用户通过自然语言与大型语言模型交互，由模型理解意图并调用相应的工具来执行播放控制、音乐搜索、队列管理等任务，将复杂的设备操作简化为对话。
使用时，用户只需像与朋友聊天一样提出需求，例如“播放一些轻松的爵士乐”或“把这首歌加到我的收藏歌单里”。智能体会自动规划并执行一系列底层操作，如搜索曲目、管理队列、调整音量等，用户可以在命令行通过 --verbose 参数实时查看工具调用过程，了解其工作流。
该工具非常适合那些拥有 Sonos 多房间音响系统，并希望用更自然、便捷方式享受音乐的用户。无论是家庭场景中的普通音乐爱好者，还是希望在工作或聚会中快速切换背景音乐的人，都能从中受益。它尤其适合不熟悉 Sonos App 所有功能，或觉得手动操作繁琐的用户。
建议在使用前确保 Sonos 音箱与运行该智能体的设备处于同一网络。初次使用时可开启 --verbose 模式以熟悉其工作逻辑。对于涉及个人歌单或敏感操作，建议先在小范围测试。由于依赖网络和模型理解，在表达复杂或模糊指令时可能需要更具体的描述。
核心特点
与单纯提供 API 封装的 Sonos 控制工具不同，它深度集成了 LLM 的规划与理解能力，能够将模糊的自然语言指令（如“找些适合工作的背景音乐”）自动分解并执行为一系列具体的搜索、添加和播放操作。同时，它独特地支持本地文件系统歌单与原生 Sonos 系统歌单的双向管理，提供了更灵活的音乐库整合方案。
注意事项
不适合需要极低延迟、精确到毫秒级的专业音频控制或自动化脚本集成场景。
常见问题
如何查看智能体具体执行了哪些操作？
在启动命令中添加 `--verbose` 或 `-v` 参数，即可在终端实时显示所有工具调用详情。
它能控制不在同一网络的 Sonos 音箱吗？
不能，运行该智能体的设备必须与要控制的 Sonos 音箱处于同一局域网内。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/sonos-mcp/raw/index.md 读取 sonos_mcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/sonos-mcp/raw/index.md（查看排版版本）