BRYG

---

什么是 BRYG？

BRYG 以普通 stdio 服务的形式实现了 Model Context Protocol (MCP)，因此任何兼容的客户端——Claude Code、Claude Desktop、Hermes、Cursor 等——都能控制你设备上的 Chromium 浏览器。它为 AI 助手提供 43 个工具，涵盖感知、操作和观察，基于日常 QA 工作设计，而非演示场景。

注意： 此仓库用于托管 BRYG 的公开文档和问题跟踪器。产品本身是一个独立的二进制文件，通过下方的安装程序分发，下载时会通过 SHA-256 校验和验证。

开始使用

BRYG 是一款需要授权的产品——你需要密钥才能激活。整个过程大约需要一分钟：

1. 获取许可证密钥——在 bryg.pages.dev 开始 14 天免费试用，并选择所需的设备数量（每台设备每月 $3）。许可证密钥会通过电子邮件发送给你（账单、取消和退款均通过该邮件中提供链接的客户门户处理）。
2. 安装——运行适用于你操作系统的一行式安装程序（见下文）。
3. 激活——引导式设置会在安装期间询问你的密钥，你也可以随时运行 bryg activate <key>。

为多台设备购买许可证

每台设备都需要自己的许可证密钥，每个密钥可激活一台设备。在结账时选择设备数量——3 台设备每月 $9。你自己的密钥会立即发放；对于每台额外设备，你需要输入一个电子邮件地址，系统会向该地址发送邀请链接，以便为那台设备发放专属密钥。你的所有密钥都会列在同一个客户门户中，你可以随时添加或移除设备，费用将按比例调整。

安装

macOS / Linux

curl -fsSL https://bryg.pages.dev/install.sh | sh

Windows（PowerShell）

irm https://bryg.pages.dev/install.ps1 | iex

安装程序会将适用于你的操作系统/架构的二进制文件下载到 ~/.bryg/bin/（Windows 上为 %USERPROFILE%\.bryg\bin\），验证其 SHA-256 校验和，然后运行引导式设置，将 BRYG 注册到你的 MCP 客户端（一个或多个），可选择安装 OCR 支持，并激活你的许可证密钥。

在 Linux 上， BRYG 会操控 Google Chrome（不支持 Edge），并在没有显示器时自动以无头模式运行——适用于服务器和 SSH 会话。没有 root 权限来安装 Chrome？将 Chrome for Testing 解压到 ~/.bryg/chrome-linux64/。请参阅 Linux 说明。

npm / npx——如果你更愿意直接配置 MCP 客户端（需要 Node.js 18+）：

{
  "mcpServers": {
    "bryg": { "command": "npx", "args": ["-y", "bryg-mcp"] }
  }
}

bryg-mcp 是一个启动器：首次运行时，它会将适用于你平台的 BRYG 引擎下载到 ~/.bryg/bin，验证其校验和，然后启动引擎——使用与上述安装程序相同的引擎、许可证和 ~/.bryg 目录。使用 npx bryg-mcp activate <key> 激活；其他命令的用法均相同。

为什么选择 BRYG

• 像理解结构一样理解网页 — 提供无障碍树快照和稳定的元素引用（[ref=N]）；内容精简可靠，便于 AI 操作，并支持坐标回退。
• 内置 OCR 和 QR 码识别 — 可读取画布、图片和游戏中的文本（支持多种 OCR 策略和任意 Tesseract 语言），并解码页面上的 QR 码。
• 网络捕获 — 可记录全部网络活动、按关键词筛选，或仅记录失败请求。敏感标头以及类似密码或令牌的字段默认会遮蔽。
• 凭据留在本地 — 机密信息绝不会进入 AI 对话。
• 专为有头模式设计 — 提供专用浏览器实例，你可以随时查看并接管（在无显示器的 Linux 上会自动以无头模式运行）。
• 零遥测 — 完全在你的计算机上运行；唯一的网络请求用于许可证验证和匿名更新检查。

工具（43）

感知 — browser_snapshot · browser_read · browser_screenshot · browser_ocr · browser_qr 操作 — 导航 · 点击 · 输入 · 填写 · 滚动 · 按键 · 拖动 · 上传 · 选择等 观察 — network_start · network_stop · network_status

请参阅完整工具参考。

命令行界面

命令	描述
bryg	启动 MCP 服务（stdio）——这是 MCP 客户端运行的命令
bryg setup [--yes] [--no-ocr] [--no-path]	引导式设置（可重复运行）
bryg activate <key>	在此计算机上激活许可证
bryg deactivate	释放此计算机的许可证席位
bryg update [--check]	更新 BRYG（通过校验和验证）
bryg browser launch [url] | stop	管理专用自动化浏览器
bryg uninstall [--yes]	停用席位、取消注册并移除 ~/.bryg

向 MCP 客户端注册

bryg setup 会为你将 BRYG 注册到 Claude Code 和 Claude Desktop。对于其他客户端，请将其指向作为 stdio 服务的二进制文件。以 Hermes 为例，只需在 ~/.hermes/config.yaml 中添加几行，然后运行 /reload-mcp：

mcp_servers:
  bryg:
    command: "${userHome}/.bryg/bin/bryg"
    args: []
    enabled: true

文档

完整文档——涵盖安装、命令行界面、配置、全部 43 个工具、许可证常见问题和更新日志——请参阅 bryg.pages.dev/docs。

支持

• 🐛 发现错误或有功能建议？提交 issue。
• 💬 有问题？请查看常见问题，或通过网站联系我们。

许可证

BRYG 是根据其最终用户许可协议提供的商业软件。本仓库的文档内容版权归 BRYG 所有。BRYG 二进制文件并非开源。