ABM 是 a browser mcp 的简称。本仓库是 ABM 的 Chrome 扩展端,开源。它把用户自己的浏览器连接到 ABM 托管服务,让 MCP 客户端执行页面自动化、数据提取、网络检查和文件/视频投递。
- 官方服务:https://abm.borgle.io
- 文档索引:docs/README.md
- 架构设计:docs/architecture.md
- 详细设计:docs/detailed-design.md
- 数据流:docs/data-flow.md
- 使用场景:docs/scenarios.md
- 隐私政策:docs/PRIVACY.md
- 发布与签名:docs/RELEASING.md
- 标签管理:导航、创建、查询、更新、激活和关闭;按站点、同源或
reuseKey复用标签。 - 页面自动化:等待元素、点击、填表、键盘输入、CDP 鼠标点击和滚动。
- 页面数据:提取 DOM、读取
window/document、在 MAIN world 执行脚本;页面 CSP 禁止 eval 时自动用 CDP 兜底。 - 网络与文件:拦截并检查网络请求,上传 base64、URL 或本地路径文件。
- 视频投递:URL 源由扩展直连;bridge 仅用于必须中继的场景;本机大文件优先使用本地路径注入。
- 连接与通知:WebSocket 自动重连、Key 失效处理、通知角标和可信视频桥配置。
- 一键连接:控制台可通过受信外部消息写入服务器地址和 API Key,扩展校验同源后保存并连接。
- 中英文界面:popup 默认跟随 Chrome UI 语言(其他语言回退英文),支持手动切换,选择保存在
abm.lang;扩展名称和描述随 Chrome 语言本地化。 - 工具描述和工具错误使用英文规范文案,页面内提示按界面语言本地化。
打开 ABM 官方服务,创建 API Key 后即可免费使用。
- 克隆本仓库。
- 打开
chrome://extensions,启用开发者模式。 - 点击“加载已解压的扩展程序”,选择本仓库目录。
- 打开扩展 popup,填写服务地址和 API Key。
扩展源码可直接加载,不需要构建步骤。npm install 只用于运行测试、生成预览和打包。
服务地址默认是:
https://abm.borgle.io
扩展会自动派生 WebSocket 地址:
wss://<server>/api/v1/extension/ws
API Key 格式:
abm_<public-prefix>_<secret>
需要控制该浏览器连接的 MCP 客户端必须使用同一把 Key。
MCP 客户端 <-> ABM 托管服务 <-> WebSocket(abm/1) <-> Chrome 扩展 <-> 页面
扩展主动连接 ABM 服务,只执行已认证的工具请求;页面操作结果通过 ABM 服务返回给 MCP 客户端。消息使用 abm/1 信封:
{"v":"abm/1","id":"message-id","type":"tool.invoke","payload":{}}扩展端只实现客户端协议,通过 WebSocket 连接 ABM 托管服务。
browser_navigate 根据目标 URL 推导复用范围,不需要维护站点白名单:
reuse |
复用范围 |
|---|---|
true / "site"(默认) |
同主机,忽略 www.、m.、mobile. 前缀,不跨子域 |
"origin" |
协议、主机、端口完全一致 |
false |
总是新建标签 |
只复用属于 abm:browser 自动分组的标签,不会接管用户的私人标签页。同一站点需要多个独立工作标签时传 reuseKey:同一 key 始终落到同一个标签,首次出现会新建,不复用同站点其他标签。
npm install
npm test
npm run syntax
npm run previewnpm test:单元测试和契约检查npm run syntax:检查全部 JS 和 manifest 引用npm run preview:生成 popup 预览- 打包、CRX 签名、GitHub Release 和 Chrome Web Store 发布见 docs/RELEASING.md
目录概览:
src/ 扩展后台、工具和连接逻辑
inject-scripts/ ISOLATED/MAIN world 注入桥与执行器
popup/ 扩展设置和状态界面
_locales/ 扩展名称和描述的中英文资源
test/ 自动化测试
docs/ 架构、详细设计、数据流、场景、隐私和发布文档
- API Key 只保存在扩展本地存储,不向普通网页暴露。
- 视频桥只接受 manifest
externally_connectable.matches中声明的可信来源。 - 域名权限必须显式申请,用户可随时撤销。
- 扩展不保存账号密码或账号会话 Cookie。
browser_inject_script在 MAIN world 执行;页面 CSP 禁止 eval 时才会临时附加 CDP,并在执行后释放。
完整的数据处理说明见 隐私政策。
本仓库只维护 Chrome 扩展端;账号和托管服务相关问题请通过官方服务渠道反馈。扩展端的 Bug 和 PR 欢迎提交到本仓库。
扩展端代码采用 MIT 许可证。
本扩展的浏览器自动化能力与交互设计根据 X-MCP 演化而来。感谢 xpzouying 及 X-MCP contributors 的公开工作。