更好的 AI 浏览器工具（BABU）

面向您已使用的 Chrome 会话的令牌高效型 MCP 控制——标签页、Cookie、登录状态，一应俱全。BABU 可将任何兼容 MCP 的编码代理连接到本地 Chrome 扩展，而无需启动单独的自动化配置文件。

为什么选择 BABU

• 默认仅四个精简 MCP 模式，而非二十个重复的浏览器工具。

• 渐进式披露： browser_read 返回有界文本和紧凑控件；browser_help 仅在请求时显示命令详情。

• 快速操作： browser_do 调度导航、点击、输入、按键、滚动、等待、截图、JavaScript 以及回环文件上传。

• 真实浏览器状态： 使用您现有的 Chrome 标签页和已认证会话。

• 便携安装： 通过 uvx 直接从 GitHub 安装；所有文档化的客户端均使用标准 MCP stdio。

• 本地优先： 唯一的网络监听器绑定到 127.0.0.1；扩展的 WebSocket 需要生成的配对令牌。

已发布的 MCP v2 模式在紧凑模式下测量为 567 个令牌，而旧版二十工具界面为 2,219 个令牌：每次模型交互节省 74.05% 的模式上下文（o200k_base，规范 JSON，不含客户端框架）。

架构

MCP client
   |  stdio (client-owned subprocess)
   v
BABU Python bridge
   |  authenticated WebSocket ws://127.0.0.1:8765
   v
BABU Chrome extension (MV3) -> your real Chrome tabs

安装

先决条件：uv 和 Chrome 116 或更高版本。

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup

该命令会将打包的扩展导出到 ~/.babu/extension，创建 ~/.babu/token，并打印一次配对令牌。

在 Chrome 中：

1. 打开 chrome://extensions。

2. 启用开发者模式。

3. 选择加载已解压的扩展程序，然后选择打印出的扩展目录。

4. 打开 BABU 扩展，粘贴配对令牌，然后选择保存。

稳定版 Chrome 不再接受自动化的 --load-extension 安装，因此需要一次性手动加载。

将 BABU 添加到 MCP 客户端

使用以下 stdio 启动定义：

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0",
    "babu",
    "mcp"
  ]
}

Hermes、Codex、Claude Code、Cursor、VS Code、Zed、ZCode、Gemini CLI、OpenCode、Cline、Windsurf、Pi 和 Agent Prime 的精确配置命令见 docs/CLIENTS.md。

同一时间只能有一个 BABU 进程占用 WebSocket 端口 8765。启动新的 BABU 启用工具链之前，请先关闭另一个。

MCP 工具

browser_do 命令：

list_tabs, get_active_tab, open_tab, close_tab, activate_tab, navigate,
get_state, snapshot, click, hover, type, select, press, scroll, extract_text, screenshot,
eval, upload_files, wait_for, back, forward, reload

推荐流程：

1. 使用相关的 query 调用 browser_read。

2. 将返回的元素索引传递给 browser_do，配合 click 或 type 使用。

3. 导航或重大 DOM 变化后重新读取，因为索引是文档局部的。

4. 仅在命令参数不明确时使用 browser_help。

截图默认保存到系统临时目录；除非显式设置 include_data_url=true，否则模型上下文中不包含 base64 图像字节。

CLI 工具

babu setup [--force]            # export/update extension and create token
babu token                      # print the current pairing token
babu mcp                        # stdio MCP server, compact profile
babu relay list_tabs            # direct browser command without an MCP client
babu relay navigate '{"url":"https://example.com"}'

babu relay 适用于偏好 CLI 工具而非 MCP 的极简工具链。

工具配置文件

• compact（默认）：上述四个工具。

• legacy：为偏好每个操作一个模式的客户端提供的二十个直接浏览器工具。

• all：两种界面。

使用 --tool-profile compact|legacy|all 或 BABU_TOOL_PROFILE 选择配置文件。

安全

BABU 控制已登录的浏览器配置文件，因此请将其视为强大的本地工具。

• WebSocket 监听器仅绑定到 127.0.0.1；MCP 通过 stdio 传输。

• Chrome 扩展来源和客户端角色均经过验证。

• 扩展与桥接通道之间使用存储在 ~/.babu/token 的 256 位令牌。

• 扩展弹出窗口可以立即禁用所有控制。

• 密码、OTP 和支付字段在常规读取中会被自动编辑。

• browser_eval 按设计在页面的主世界中执行 JavaScript。

• 文件上传仅接受有界、直接的回环 HTTP(S) URL，且不携带凭据。

请审查每次 MCP 工具调用，并使用各客户端的批准控制机制。

限制

• Chrome 内部页面、PDF 查看器、未加载的标签页以及 iframe 或 shadow root 内的控件无法被驱动。

• 严格的页面 CSP 可能会阻止 browser_eval；DOM 读取/点击/输入工具仍然可用。

• browser_press 支持 Enter、Tab 和合成 Escape；文本输入请使用 browser_type。

• 更新后，必须从 chrome://extensions 重新加载已解压的扩展，然后重启 MCP 客户端。

• 服务器按设计为单客户端、单浏览器扩展。

更新

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup --force

在 chrome://extensions 中重新加载 BABU，然后重启 MCP 客户端。采用新版本时，请更新客户端配置中的 Git 标签。

许可证

MIT