@anvailabs/ 代理浏览器- mcp
MCP 服务器 代理浏览器。两个安装路径,一个来源:
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。 见 快速引用。 。 。 .
曝光 Agent Browser 作为一小组高水平、安全、可堆肥的MCP工具 (ADR-009) (英语). 原始引擎操作——评价,路由,选择器,低等 输入——故意不暴露.
工具表面
见 生成的工具目录 无约束和授权
表面、所需论据和产出合同。 这是从实际 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 工具规格
定义结构/文本相容行为.
自动填充和计划报告失败( E)ok: false现在设置 isError: true 在两个议定书中
保留完整的收/结果JSON。 这改变了1.8.18的出错信号;
委托人应当检查保留的报告,不得将其作为复试指令.
成功 verify: none 报告没有规定核查或适用承诺.
无效的上游批量报告返回一个不确定的已消毒文本错误
指示,绝不是编造出来的结构化成功或自动第二次写入.
有效报告存在之前的错误仍然是没有结构化内容的文本诊断.
这种运输资格尚未证明结构化-结果消费 安装了 Victor, Codex 或 Claude 客户端. 这仍然是T8机床接受.
对于合格的本地表格,更喜欢 autofill; 检查每个字段的核查
接收和保存不确定的文字。 用于明确的不同步骤
snapshot → 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 不定义路径.
关于可复制的研究烟雾及其限度,见 研究资格。 。 。 .
运行它
释放消费者:单二进制(推荐)
下载 agentbrowser-mcp-<target> 从
GitHub 发布
(核实反对) sha256sums.txt),然后将MCP客户端指向它——No Node,
没有pnpm,没有 repo 退出 :
# ~/.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);每个消费过程都产出二进制.
发展:来自工作空间
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(中文(简体) ) |
建造并取出二进制
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。 。 。 .