# @anvailabs/agentbrowser-mcp 中文文档

规范地址：https://npmcn.com/package/%40anvailabs/agentbrowser-mcp/

版本：1\.34\.0
npm 元数据更新时间：2026-11-06T00:51:25.913Z
中文译文更新时间：2026-11-06T07:34:14.570Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anvailabs/agentbrowser-mcp
原文对照：https://npmcn.com/package/%40anvailabs/agentbrowser-mcp/?lang=original
项目主页：https://github.com/anvai-labs/agentbrowser#readme
源码仓库：https://github.com/anvai-labs/agentbrowser

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.6 MB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-09-03T04:51:56.428Z
- 最新版本发布：2026-11-06T00:51:25.581Z
- 近 30 天下载量：4672（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：64（近 12 个月 64 个）

## 中文简介

MCP 服务器将 Agent Browser 暴露为高级,安全,可堆肥的工具(通过 AGENTBROWSER BASE URL 访问 Agent Browser 服务)

## 安装

```sh
npm install @anvailabs/agentbrowser-mcp
```

也可以使用：`pnpm add @anvailabs/agentbrowser-mcp`、`yarn add @anvailabs/agentbrowser-mcp`、`bun add @anvailabs/agentbrowser-mcp`

## README

# @anvailabs/ 代理浏览器- mcp

MCP 服务器 [代理浏览器](https://github.com/anvai-labs/agentbrowser)。两个安装路径,一个来源:

```sh
npm i -g @anvailabs/agentbrowser-mcp   # Node >= 18
# or: download the bun-compiled standalone binary from the GitHub Releases
```

软件包是 **仅使用 MCP stdio 适配器** 它代表着Browser探员的服务 指着一个 `AGENTBROWSER_BASE_URL` (默认) `http://localhost:5709`) (中文(简体) ).

## 检查来源前发现用途

`tools/list` 包括会议、饼干和局域网关于 相关工具. `create` 返回两个 `sessionId` 和首页 `pageId`· ; 设定 `headless: false` 用于显示窗口 **服务器** 主持人。 国 际 `session create` 只返回一个会话, 所以 shell 客户端也必须调用 `page create`。 。 。 .

当 shell 可用时, 使用 `agentbrowser --help` 离线 `agentbrowser describe session create` 编号 : `describe navigate` 编号 : `describe plan --schema` 用于示例和精确的CLI语法. `AGENTBROWSER_BASE_URL` 配置此适配器; cLI 的用途 `--base-url`。既不重新配置运行中的 REST 服务器. 运算符可以设置 `AGENTBROWSER_ALLOWED_CIDRS` 打开 **启动时代理浏览器服务器** 用于特定授权的局域网主机。 这永远不会放松回放/元数据块或 超过会话主机限制 。 没有每个工具的政策扩大论点.

Cookie工具结果包含证书. 偏好CLI的私人文件进出口 酌情核实在播种后预期得到认证的UI。 见 [快速引用](https://npmcn.com/package/docs/cli-agent-usage.md#find-the-answer-in-cli-help-first)。 。 。 .

曝光 Agent Browser 作为一小组高水平、安全、可堆肥的MCP工具 (ADR-009) (英语). 原始引擎操作——评价,路由,选择器,低等 输入——故意不暴露.

## 工具表面

见 [生成的工具目录](https://npmcn.com/package/docs/mcp-tool-catalog.md) 无约束和授权 表面、所需论据和产出合同。 这是从实际 `tools/list` 反应,并附有一份摘要,内容为完整描述和计划。 现有版本 文物检查 拒绝漂移。 建造后再生 `node scripts/mcp-catalog-docs.mjs --write`。 。 。 .

`session` 检查元数据和页 `sessionId`授权 连接绑定的 ID 和 同一响应中也包含当前 控制状态。 工具需要两种 `session.control` 财务报告和审定财务报表 `page.observe`; 应用程序 因此,模式并不显示。 委托模式删除创建/关闭/cookie并添加 `operation` (行动状态). `AGENTBROWSER_MODE` 修正一个配置文件 桥连接寿命。 重新连接到更改配置文件; 客户端可能缓存 目录. 从您自身的关联获取有效的目录 `tools/list`· ; 元数据从不扩展会话授权,服务拒绝一个工具调用 无记名赠款的简介不允许,即使不匹配的桥梁广告也不允许.

`qa`, (中文(简体) ), `operations`, (中文(简体) ), `appsec`, (中文(简体) ), `bounty`,以及 `forms` 目前预计完成 浏览器目录. `audit` 省略批量自动填充. `application` 只披露授权 操作调节直到T4发布被打入的应用程序工具. 这些刻意 重复避免虚构上下文的节省; 生成的目录记录的准确结果 每个配置和绑定的字节 .

### 协议和结果兼容性

基金会候选人支持MCP `2024-11-05` 财务报告和审定财务报表 `2025-06-18`明确遗产 客户端保留了文本JSON和目录,没有输出计划/注释. 更新或 提供的版本未知 `2025-06-18`;客户端必须支持返回 版本或断开。 缺少初始化保留历史文本行为; 客户端 应该总是握手。 连接无法在调用时重新谈判 .

下 `2025-06-18`, (中文(简体) ), `autofill` 财务报告和审定财务报表 `plan` 广告卡通 `urn:agentbrowser:autofill-report:v1` 财务报告和审定财务报表 `urn:agentbrowser:plan-report:v1` 已验证的策略和返回 `structuredContent` **加上相同的序列 JSON 文本**计划保留可选模式/修订元数据,以保留现有的SDK合同; 当前的服务器总是提供它。 其他工具仍在返回 文本 JSON; 没有创建不合格的输出计划。 两种工具的说明都明确 声明它变异,不能安全重复。 提示不是授权或证据 浏览器/后端支持。 这个 [MCP 工具规格](https://modelcontextprotocol.io/specification/2025-06-18/server/tools) 定义结构/文本相容行为.

自动填充和计划报告失败( E)`ok: false`现在设置 `isError: true` 在两个议定书中 保留完整的收/结果JSON。 这改变了1.8.18的出错信号; 委托人应当检查保留的报告,不得将其作为复试指令. 成功 `verify: none` 报告没有规定核查或适用承诺. 无效的上游批量报告返回一个不确定的已消毒文本错误 指示,绝不是编造出来的结构化成功或自动第二次写入. 有效报告存在之前的错误仍然是没有结构化内容的文本诊断.

这种运输资格尚未证明结构化-结果消费 安装了 Victor, Codex 或 Claude 客户端. 这仍然是T8机床接受.

对于合格的本地表格,更喜欢 `autofill`; 检查每个字段的核查 接收和保存不确定的文字。 用于明确的不同步骤 `snapshot` → `plan` ——见: [主读取器](https://npmcn.com/package/README.md#the-fast-path-for-forms-snapshot-then-plan)。 。 。 .

## 多页和大量研究成果

`create` 仍然返回初始状态 `pageId`启用 `page_create` 与 那个 `sessionId` 和可选的 HTTP( S) `url` 创建同一页面 饼干背景。 使用 `pages` 发现页码,包括被采纳的弹出; 永远不会发明一个ID或者期望导航会隐含地创建一页. 这些工具 授权给现有的SDK,服务仍然是授权/政策所有人. 相同的 shell 接口仍然保留 `agentbrowser page create --help` 财务报告和审定财务报表 `agentbrowser page list --help`。 。 。 .

强制创建需要 `operationId` 在发送前选择。 控制的会议 切换该ID,但操作状态不保留由此产生的页面ID. 常会 `create` 不从身份证上复制 一个人 不在两种情况下自动重试一个不确定的创建; 存货是 无法证明同时生成的哪一页。 一般的明页配额 并且结果相关性仍然是后续的,与现有的弹出上限不同.

`extract` 保存完整 `data` 和内部证据 `maxBytes`。 。 默认上限是紧凑 JSON 的 1 MiB , 包括证据; 操作员可以提出 上限为 `AGENTBROWSER_EXTRACT_MAX_BYTES` 在开始服务前. Raw HTML 大小不是提取结果大小 。 超限结果显然失败, 没有部分JSON。 MCP 文本信封是单独序列化的,可以 大一点 Claude或另一条绳子所写的任何外溢文件都属于 绳接; Agent Browser 不定义路径.

关于可复制的研究烟雾及其限度,见 [研究资格](https://npmcn.com/package/docs/spec/evidence/consumer-research-smoke.md)。 。 。 .

## 运行它

### 释放消费者:单二进制(推荐)

下载 `agentbrowser-mcp-<target>` 从 [GitHub 发布](https://github.com/anvai-labs/agentbrowser/releases) (核实反对) `sha256sums.txt`),然后将MCP客户端指向它——No Node, 没有pnpm,没有 repo 退出 :

```yaml
# ~/.victor/mcp.yaml
mcpServers:
  agentbrowser:
    command: /usr/local/bin/agentbrowser-mcp
    env:
      AGENTBROWSER_BASE_URL: http://localhost:5709
```

二进制是 **只有 MCP 适配器** (TD-BROWSER-5范围边界):它需要 可达代理浏览器服务器 `AGENTBROWSER_BASE_URL` 任何东西 除了协议握手。 一次部署服务器(释放柏油球,或 `node packages/api/dist/bin.js`);每个消费过程都产出二进制.

### 发展:来自工作空间

```sh
pnpm --filter @anvailabs/agentbrowser-mcp build
node packages/mcp-server/dist/bin.js
```

### 环境

| 变量 | 含义 |
| --- | --- |
| `AGENTBROWSER_BASE_URL` | 代理浏览服务器到代理服务器( 默认) `http://localhost:5709`(中文(简体) ) |
| `AGENTBROWSER_API_KEY` | 当服务用到时 `AGENTBROWSER_API_KEYS` 配置 |
| `AGENTBROWSER_SESSION_ID` | 运算符配置的已授权会话绑定; 使用当前授权证书作为 API 密钥 |
| `AGENTBROWSER_MODE` | 此连接的固定模式配置 : `qa` (违约), `operations`, (中文(简体) ), `audit`, (中文(简体) ), `appsec`, (中文(简体) ), `bounty`, (中文(简体) ), `forms`,或 `application` |
| `AGENTBROWSER_MCP_VERSION` | 覆盖报告 `serverInfo.version` (调试;否则二进制时会从 `package.json`(中文(简体) ) |

## 建造并取出二进制

```sh
pnpm --filter @anvailabs/agentbrowser-mcp compile   # -> dist-bin/agentbrowser-mcp (needs bun)
pnpm --filter @anvailabs/agentbrowser-mcp smoke     # stdio handshake + full tool-catalog gate
```

交叉编译 `node scripts/compile.mjs --target=bun-linux-arm64 --outfile=...`。 。 。 . CI在每一个公关上运行`Bun compile + smoke` 和每个 `v*` 标签 发布五个目标释放矩阵-见 `docs/td/TD-BROWSER-5-single-binary-mcp-distribution.md`。 。 。 .

## 常见问题

### @anvailabs/agentbrowser-mcp 是什么？

MCP 服务器将 Agent Browser 暴露为高级,安全,可堆肥的工具\(通过 AGENTBROWSER BASE URL 访问 Agent Browser 服务\)

### 如何安装 @anvailabs/agentbrowser-mcp？

在项目目录运行 npm install @anvailabs/agentbrowser-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentbrowser-mcp，可以用 npx agentbrowser-mcp 直接运行。

### @anvailabs/agentbrowser-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @anvailabs/agentbrowser-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @anvailabs/agentbrowser-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @anvailabs/agentbrowser-mcp 可以商用吗？

@anvailabs/agentbrowser-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @anvailabs/agentbrowser-mcp 的下载量有多少？

根据 npm 官方下载统计，@anvailabs/agentbrowser-mcp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,672 次，日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @anvailabs/agentbrowser-mcp 还在维护吗？

最新版本 1\.34\.0 发布于 2026/11/06（1 天前）；至今共发布 64 个版本，其中过去 12 个月发布了 64 个；首次发布于 2026/09/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。