Atlas / MCP servers / xvhuan / Xiaoi

XiaoiCAUTION

Name: Xiaoi
Author: xvhuan

mcp/xvhuan/xiaoi

MCP server by xvhuan · claude · codex · mcp · Audited 2026-10-06

⚑ Report / re-scan Source ↗

小爱音箱语音通知工具:提供 CLI/TUI/MCP/Webhook 一键播报与控制音量,支持 PM2 常驻部署,支持docker部署。

Verdict

CAUTION

Grade

Trust score

88 /100

Exposed tools

5 4r · 1w · 0d

Transport

stdio

License

MIT

Stars

204

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

██╗  ██╗██╗ █████╗  ██████╗ ██╗
╚██╗██╔╝██║██╔══██╗██╔═══██╗██║
╚███╔╝ ██║███████║██║   ██║██║
██╔██╗ ██║██╔══██║██║   ██║██║
██╔╝ ██╗██║██║  ██║╚██████╔╝██║
╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝

小爱音箱语音通知工具

通过 CLI / TUI / MCP / Webhook 向小爱音箱发送语音通知

[](https://nodejs.org/) [](LICENSE) [](https://www.npmjs.com/package/xiaoii)

功能

TUI 交互界面:配置账号、发送通知、管理 Webhook/PM2
CLI 命令:适合脚本/自动化场景
MCP Server:供 Codex/Cursor/VS Code 等 AI 编程助手调用
Webhook 服务:提供 HTTP 接口,方便第三方系统集成
多音箱路由:支持维护音箱列表、设置默认音箱、按请求 did 临时覆盖
PM2 常驻:一键后台运行 Webhook(不需要挂着终端)

更新日志

v1.0.10 (2026-02-14)

新增多音箱路由能力:支持 speaker.defaultDid 与 speaker.speakers,并兼容旧 speaker.did
Webhook 四个接口支持 body 传 did(tts/audio/volume/command),不传按默认优先级路由
新增 TUI「音箱列表管理」:支持添加设备、设置默认、启用/禁用、删除
新增 CLI MiOT 能力:xiaoi command(动作)与 xiaoi getprop(属性读取)
新增 MCP 工具:do_action 与 get_property,并统一支持可选 did
Docker/文档更新:新增 XIAOI_DEFAULT_DID 与 OH2P(xiaomi.wifispeaker.oh2p)简单 cmd 用例

v1.0.9 (2026-02-14)

修复 .mi.json(登录凭证缓存)在任意目录执行 CLI 时被写到当前目录的问题,现在固定写入 ~/.xiaoi/ 目录

v1.0.8 (2026-02-12)

修复 Docker 容器启动失败:移除 pm2-runtime 不支持的 --log-date-format 参数
修复 Docker 构建失败:npm ci 改为 npm install(兼容 pnpm 项目)
文档补充 XIAOI_TOKEN 环境变量示例,方便用户自定义 Webhook 鉴权 Token

v1.0.7 (2026-02-12)

新增 Docker 容器化部署:支持通过环境变量配置,无需手动编辑配置文件,一行命令即可启动 Webhook 服务
新增 GitHub Actions CI/CD:打 tag 自动发布 npm 包 + 构建推送 Docker 镜像(Docker Hub + GHCR,支持 amd64/arm64 双架构)
新增 .env.example 环境变量模板,降低 Docker 部署门槛
容器内使用 PM2(pm2-runtime)管理进程,自动健康检查与重启

v1.0.6 (2026-02-12)

修复 ttscmd 输入解析错误:[7,3] 不再被误解析为 [0,7]
优化账号设置显示:默认 ttscmd 未设置时,自动显示当前 did 解析出的设备命令(自动映射)

v1.0.5 (2026-02-12)

新增 ttscmd 自动映射日志输出:显示 model / match / source / command
详细日志统一增加 [XIAOI]

Read from source at commit db3cd6cd8f34OBSERVED · 2026-10-06

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add xiaoii --env XIAOI_WEBHOOK_TOKEN=${XIAOI_WEBHOOK_TOKEN} -- npx -y [email protected]

claude-desktop

{
  "mcpServers": {
    "xiaoii": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "XIAOI_WEBHOOK_TOKEN": "${XIAOI_WEBHOOK_TOKEN}"
      }
    }
  }
}

Exposed tools (5)

4 read · 1 write · 0 destructive.

Tool	Risk	Description
`do_action`	read	向小爱音箱发送 MiOT 指令。
`get_property`	read	读取小爱音箱 MiOT 属性值。
`notify`	read	向小爱音箱发送语音通知。适用于任务完成通知、提醒、警告等场景。音箱会用 TTS 播报传入的文字内容。
`play_audio`	read	让小爱音箱播放指定的音频链接。
`set_volume`	write	设置小爱音箱的音量。

Trust audit

CAUTIONgrade B · trust 88/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	WARN
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED