内容
# Antigravity 浏览器桥
> 适用于 MCP 代理与用户已认证 Chrome 之间的开源桥梁，具备明确的标签授权和 DOM 操作验证。
[English 文档](README.en.md) · [贡献](CONTRIBUTING.md) · [安全](SECURITY.md) · [路线图](docs/ANTIGRAVITY_APEX_PLAN.md) · [更新日志](CHANGELOG.md)
> **状态：** `0.1.0-beta.2`。请谨慎用于个人账户，并始终审查重要操作。
<img src="extension/icons/icon-128.png" alt="Antigravity 浏览器桥图标">
## 本项目解决的问题
依赖键盘自动化、屏幕坐标、PowerShell 或 VBS 的工具依赖于焦点、加载时间和视觉状态。它们可能会点击错误的窗口、错过界面更改或在未验证的情况下报告成功。
Antigravity 浏览器桥为代理提供了一个更确定的层：
1. MCP 客户端启动服务器；
2. 服务器与本地原生宿主通信；
3. 原生宿主与扩展程序保持认证连接；
4. 用户明确授权每个标签页；
5. 扩展程序观察 DOM 并生成结构化引用；
6. 代理读取、填写、点击并通过这些引用验证结果。
```text
MCP 代理
↓
MCP 服务器 / CLI Rust
↓
原生消息宿主
↓
Chrome 扩展程序
↓
授权标签页和 DOM
```
## 本项目的特点
该项目源自 [Vercel 的 agent-browser](https://github.com/vercel-labs/agent-browser)，采用 Apache 2.0 许可证，但添加了自己的层，专注于安全使用用户的日常浏览器：
- MCP 配置文件 `antigravity-work`；
- 重用已打开的 Chrome 和现有的认证会话；
- Chrome 的通用扩展程序；
- Windows 上的原生消息传递；
- 按标签页明确授权；
- 仅在同一域名内持久化；
- 跨域导航自动撤销；
- 原生宿主诊断和安装；
- 公共、破坏性或财务操作确认指南；
- 具有故障恢复、成功证据和风险控制的路线图。
这些添加将上游基础转换为适用于需要处理真实会话而非静默访问整个浏览器的代理的桥梁。
## 用例
- 在 LinkedIn 上准备帖子并在发布前请求确认；
- 在已认证的标签页中填写表单；
- 在不共享 cookie 的情况下查询 Web 系统；
- 使用 DOM 中的后续验证自动化重复性任务；
- 将 Antigravity 或其他 MCP 客户端集成到浏览器的流程中；
- 在具有明确授权限制的真实 Web 应用程序中测试代理。
## 当前状态
当前功能：
- 通过 `antigravity-work` 配置文件连接 MCP；
- 使用已打开的 Chrome；
- 授权标签页列表；
- 使用引用观察 DOM；
- 点击、聚焦、填充、输入和读取文本；
- 在同一域名内持久化授权；
- 跨域导航自动撤销；
- 扩展程序 ID 稳定；
- Windows 上的原生宿主安装和诊断。
测试版限制：
- 动态菜单、对话框和复杂编辑器仍需要额外操作；
- 网站界面可能会在无通知的情况下更改；
- 原生安装程序集中在 Windows 上；
- 并非所有计划工具都已实施；
- `not_implemented` 响应永远不应被视为成功。
## 要求
- Windows 10 或 11；
- Google Chrome 稳定版、测试版、开发版或 Canary 版；
- Node.js 24+；
- pnpm 11+；
- 稳定版 Rust；
- Antigravity 或其他兼容的 MCP 客户端。
## 从源代码安装
```powershell
git clone https://github.com/coelhobugado/antigravity-browser-bridge.git
cd antigravity-browser-bridge
pnpm install
pnpm build:native
```
可执行文件将生成在 `bin/agent-browser-win32-x64.exe`。
注册和验证原生宿主：
```powershell
.\bin\agent-browser-win32-x64.exe antigravity install
.\bin\agent-browser-win32-x64.exe antigravity doctor
.\bin\agent-browser-win32-x64.exe antigravity permissions
```
## 扩展程序安装
在 [Releases 页面](https://github.com/coelhobugado/antigravity-browser-bridge/releases) 上下载扩展程序或使用 `extension` 文件夹。
1. 将 ZIP 解压到永久文件夹。
2. 打开 `chrome://extensions`。
3. 启用开发者模式。
4. 点击 **加载未打包扩展程序**。
5. 选择包含 `manifest.json` 的文件夹。
6. 确认扩展程序 `1.1.2` 已正确加载。
官方 ID 是稳定的，已由安装程序授权。
## Antigravity 中的 MCP 配置
编辑文件：
```text
C:\Users\SEU_USUARIO\.gemini\config\mcp_config.json
```
添加以下配置，不覆盖现有服务器：
```json
{
"mcpServers": {
"antigravity-browser-bridge": {
"command": "C:\\CAMINHO\\antigravity-browser-bridge\\bin\\agent-browser-win32-x64.exe",
"args": ["mcp", "--tools", "antigravity-work"]
}
}
}
```
然后重新加载 Antigravity 并检查工具 `agent_browser_work_*` 是否出现。
## 安全使用
1. 在 Chrome 中打开网站。
2. 仅授权必要的标签页。
3. 在采取行动之前，请代理观察。
4. 在发布、删除、购买或发送消息之前要求确认。
5. 在操作后请求新的观察以验证结果。
示例：
```text
使用 agent_browser_work 工具。列出已授权的标签页，观察 LinkedIn 标签页，准备帖子并在我点击发布之前请求确认。然后再次观察并确认结果。
```
扩展程序不会静默访问整个浏览器。不要暴露 cookie、令牌、浏览器配置文件或本地状态文件。
## 开发和测试
```powershell
pnpm install
pnpm version:sync
cargo fmt --manifest-path cli\Cargo.toml -- --check
cargo test --manifest-path cli\Cargo.toml
node --check extension\background.js
node --check extension\content.js
```
使用 Chrome 进行端到端测试：
```powershell
cargo test e2e --manifest-path cli\Cargo.toml -- --ignored --test-threads=1
```
## 如何贡献
贡献欢迎，特别是在：
- 真实应用测试；
- 支持菜单、对话框和编辑器；
- 与其他 MCP 客户端的兼容性；
- 其他系统的安装程序；
- 安全性和故障恢复；
- 中英文文档。
在提交拉取请求之前，请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。漏洞应按照 [SECURITY.md](SECURITY.md) 中的描述进行报告。
## 路线图
当前优先级是：
- 按风险级别确认操作；
- 动态接口的更丰富操作；
- DOM 更改后的恢复；
- 自动成功或失败证据；
- 安装程序和签名包；
- X、LinkedIn 和通用应用程序上的测试；
- 更广泛地支持 MCP 客户端和操作系统。
详细计划见 [docs/ANTIGRAVITY_APEX_PLAN.md](docs/ANTIGRAVITY_APEX_PLAN.md)。
## 致谢和许可证
基于 [vercel-labs/agent-browser](https://github.com/vercel-labs/agent-browser)。该项目保留 Apache 2.0 许可证和适用通知。参见 [LICENSE](LICENSE)。
Antigravity Browser Bridge 不是 Vercel、Google、X、LinkedIn 或 Anthropic 的官方产品。
