xiaozhi-mcp-bridgeCAUTION
小智AI MCP桥接 - 让小智调用本机文件/搜索/天气/系统命令/代码执行等能力,含Web管理面板
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
让你的小智 AI 真正"用上"这台电脑:读写文件、执行命令、查天气、搜网页、写代码, 并让两个小智互相发消息。 Let your Xiaozhi AI actually use this computer: read/write files, run commands, check weather, search the web, write code — and let two Xiaozhi agents message each other.
当前版本 / Current version: v1.1.5 | 更新日志 CHANGELOG
目录 / Table of Contents
- 中文文档
- 一、这是什么
- 二、能做什么
- 三、环境要求
- 四、安装
- 五、配置接入点
- 六、启动与停止
- 七、Web 管理面板
- 八、让两个小智互相发消息
- 九、开机自启(Linux)
- 十、常见问题 FAQ
- 十一、⚠️ 局限性与已知问题
- 十二、安全须知
- 十三、升级与迁移
- English Documentation
中文文档
一、这是什么
小智 AI(xiaozhi.me)是一个语音助手。它自己不能碰你的电脑 —— 你让它"帮我看看 D 盘还剩多少空间",它只能干瞪眼。
这个项目是一座桥:它在你的电脑上跑一个小程序,通过 MCP (Model Context Protocol,一种让 AI 调用本地工具的标准协议)把小智和你的电脑连起来。 连上之后,小智就真的能读文件、跑命令、查资料了。
一句话:给语音助手装上手脚。
它由三部分组成
三者都以当前用户权限运行 —— 你用 root 启动,小智就有 root 权限。
二、能做什么
连接成功后,小智会获得这些工具(取决于你启用了哪些):
三、环境要求
1. 一台电脑
Windows / macOS / Linux 都行。这台电脑要能上网(小智的服务器在公网)。
2. Node.js 20 或更高版本
这是唯一的硬性依赖。 检查方法:打开终端(Windows 是 PowerShell / CMD),输入:
node -v
如果显示 v20.x.x 或更高就可以了。如果提示"命令不存在"或版本低于 20,去 下载 LTS 版本安装即可(一路下一步)。
为什么要求 20+:项目用到了 Node 2
a83176cc52baOBSERVED · 2026-10-11Connect
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 mcp add xiaozhi-mcp-bridge --env PANEL_TOKEN=${PANEL_TOKEN} -- npx -y [email protected]{
"mcpServers": {
"xiaozhi-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"PANEL_TOKEN": "${PANEL_TOKEN}"
}
}
}
}Exposed tools (34)
24 read · 9 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
add_note | write | 往本地记事本添加一条备忘,下次调用 list_notes 可读取。 |
base64_decode | read | 将 Base64 字符串解码为文本。 |
base64_encode | read | 将文本编码为 Base64。 |
clear_notes | destructive | 清空本地记事本。 |
dns_lookup | read | 查询域名的 DNS 记录(A/AAAA/CNAME)。 |
fetch_page | read | 抓取指定 URL 的网页正文(去除 HTML 标签),返回纯文本。 |
get_code_env | read | 查看当前代码执行环境信息(用户、权限、Python/GCC 版本)。 |
get_current_time | read | 获取本机当前日期、时间、星期和时区。 |
get_system_status | read | 查看本机系统状态:主机名、操作系统、命令行类型、CPU型号与核数、内存占用、磁盘空间、运行时间。 |
get_weather | read | 查询绵阳当前天气及未来5天预报(温度、湿度、天气状况、风速、降水)。数据来自 Open-Meteo,实时免费。 |
hash_calc | read | 计算字符串的哈希值,支持 md5/sha1/sha256/sha512。 |
http_request | read | 发送 HTTP/HTTPS 请求,返回状态码、响应头和响应体。 |
json_format | read | 格式化或校验 JSON 字符串,返回美化后的 JSON。 |
list_notes | read | 列出本地记事本里的全部备忘。 |
password_gen | read | 生成随机密码,可指定长度和字符类型。 |
port_check | read | 检测目标主机的端口是否开放。 |
qrcode_gen | read | 生成二维码图片,返回图片 URL,可直接在浏览器打开或下载。 |
read_messages | read | 消息接收工具。action=read(默认)读取新消息并更新已读位置;action=list_inbox列收件箱;action=list_outbox列发件箱;action=get_position查看已读位置;action=reset_position重置已读位置。 |
regex_test | read | 测试正则表达式,返回所有匹配结果及分组。 |
run_bash | write | 执行命令行脚本。Windows 自动用 PowerShell,Linux/macOS 自动用 Bash,返回输出。权限与当前进程一致。 |
run_c | write | 编译并运行 C 语言代码(gcc -std=c11),返回编译和运行结果。代码在临时目录编译执行。 |
run_command | write | 在本机执行命令行。Windows 自动用 PowerShell,Linux/macOS 自动用 Bash,返回标准输出和错误输出。适合执行系统命令、查进程、调用系统工具等。 |
run_dsh | write | 向本机的 DeepSeek Harness (dsh) 下达一个任务,由 dsh 这个 AI Agent 在本机自主完成(读文件、跑命令、改代码等),完成后返回结果。需本机已安装 dsh。 |
run_python | write | 执行 Python 3 代码,返回标准输出和错误。代码在临时文件中执行,执行后自动清理。 |
run_self_test | write | 运行自检:模拟小智AI作为MCP客户端,自动测试所有工具服务器(系统/网页/天气/开发者/代码/消息),输出通过/失败报告。 |
search_status | read | 查看当前搜索工具配置状态。 |
search_web | read | 多引擎聚合网页搜索(必应+360),自动合并去重,完全免费无限制。支持自然语言查询。 |
send_message | write | 消息发送工具。action=send(默认)发消息;action=recall撤回自己发的消息;action=list_users列出所有用户端。 |
timestamp_convert | read | 时间戳与日期互转。输入纯数字视为时间戳(自动判断秒/毫秒),输入日期字符串转为时间戳。 |
unit_convert | read | 单位换算,支持长度(米/千米/英尺/英里)、重量(千克/克/磅)、温度(摄氏度/华氏度/开尔文)。 |
url_decode | read | URL 解码(decodeURIComponent)。 |
url_encode | read | URL 编码(encodeURIComponent)。 |
uuid_gen | read | 生成一个 UUID v4。 |
write_file | write | 将内容写入指定路径的文件,自动创建目录。可用于保存代码文件。 |
Trust audit
CAUTIONgrade B · trust 89/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 | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (3 observation(s))
- Network
- declared (3 observation(s))
- Shell
- declared (5 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (5)
console.log(` ✅ 已配置: ${token.slice(0, 50)}...`);clear_notes
return 'u_' + crypto.createHash('sha1').update(s, 'utf8').digest('hex').slice(0, 16);return 'u_' + crypto.createHash('sha1').update(s, 'utf8').digest('hex').slice(0, 16);express
Gates applied: no_behavioural_pass.
a83176cc52bafull audit observations/trust-audit/mcp-server/znfr60__xiaozhi-mcp-bridge.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | a83176cc52ba | CAUTION | B | 89 | first audit |
Questions
What is the xiaozhi-mcp-bridge MCP server?
小智AI MCP桥接 - 让小智调用本机文件/搜索/天气/系统命令/代码执行等能力,含Web管理面板
What tools does xiaozhi-mcp-bridge expose?
34 in total: 24 read-only, 9 that write, and 1 that can delete or overwrite (clear_notes). Every one is listed on this page with its risk.
Is xiaozhi-mcp-bridge safe to connect to an agent?
With care. The audit graded it B (89/100) and found 5 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does xiaozhi-mcp-bridge need?
It reads PANEL_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How current is this page?
The grade is for one exact copy of the source (a83176cc52ba), read on 2026-10-11. The repository is watched and re-audited when it changes.