让桌上的猫替你盯 AI 干活——bongocat-mcp 使用指南#

AI 可以直接操控猫#

项目把猫的所有动作封装成了 14 个标准工具（AI 圈通用的 MCP 接口），AI 助手可以按需调用：让猫打字、敲键盘、做动作、切换表情、弹气泡、显示/隐藏猫窗口……凡是猫会做的，AI 都能让它做。

事件播报插件（ZCode 版已就绪）#

这是核心玩法。装上配套插件后，AI 助手的五个关键时机会自动触发猫的播报：

网页仪表盘#

本地起一个控制台（浏览器打开），可以看到：猫的连接状态和能力清单、全部配置项的可视化编辑、以及一个”试玩台”——在网页上点按钮就能让猫切表情、打字、冒气泡，还有最近 200 条操作流水可查。

换皮肤不用改代码#

不同皮肤的猫表情差别很大，有的甚至没做表情。插件的做法是每次播报时实时读取当前猫的表情列表，按名字找合适的目标（比如任务完成优先找”星星眼/点赞”这类）。所以：

• 换一套皮肤，猫自动适配新表情
• 皮肤没做表情 → 自动降级为只弹气泡，不报错不折腾

第一步：准备（一次性）#

1
git clone https://github.com/emicyx/bongocat-mcp
2
cd bongocat-mcp
3
python -m venv .venv
4
.venv\Scripts\activate
5
pip install -r requirements.txt

然后把示例配置复制为正式配置：copy config.example.json config.json。

第二步：启动仪表盘#

1
python dashboard.py

浏览器会自动打开仪表盘页面，保持它后台运行即可（这就是猫的”控制中枢”，日常只需要这一个命令）。

第三步：接入你的猫#

Mver 皮肤版：如果猫正在运行但还没开网络同步，在仪表盘点「🚀 一键接入 Mver 新猫」——它会自动定位猫、打开猫的网络开关、重启猫并接管，全程无需手动改配置。

TIP

一键接入会文本级改写猫的 config.json 来开启网络同步（接收模式），不改程序本体；新装的皮肤版默认不监听 UDP，点一下即可修复。

其他版本：在仪表盘的”配置编辑”里填一下猫的程序路径，或直接用自带的自动探测。

接入成功后，仪表盘的状态页会显示当前猫、它支持哪些能力、表情和动作列表。

第四步：安装 ZCode 插件#

1. 打开 ZCode → 设置 → 插件管理 → 发现 → 点 + 添加市场
2. 选择本地目录：bongocat-mcp/zcode-plugin
3. 安装列表里的 bongocat-notify（新插件默认启用）

第五步：验证#

新开一个 ZCode 会话，输入 /bongo-test——AI 会自动走一遍完整链路：确认猫在线、列出表情、现场切换两个表情、弹出测试气泡。猫表演成功，就是全通了。

之后什么都不用做：正常给 AI 派活，每次任务完成、等待审批、出错时，猫都会自动播报。

想调整播报行为？#

在插件目录放一个 bongocat-notify.json（或放在 ~/.zcode/ 下），只写想改的项：

1
{
2
  "expressionDuration": 20,
3
  "events": {
4
    "user-prompt": { "enabled": false },
5
    "stop": { "text": "🎉 搞定！{tool}", "expressions": ["点赞"] }
6
  }
7
}

上面这份配置的意思：表情保持 20 秒再回默认；每次提交任务不播报（太吵）；任务完成的文案换成”🎉 搞定！“，表情优先用”点赞”。{tool} 会自动替换成具体的工具名。