MCP

Browser Use MCP:用无障碍数据做浏览器自动化

适合要让模型通过 Puppeteer 结构化无障碍数据操作浏览器的人,前提是本机已安装 Node.js 18 或更新版本。

官方来源 · Browser Use MCP Server

安装

code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'

适合谁

如果你要让大模型操作浏览器,并且希望默认走 Puppeteer 的结构化无障碍数据、而不是一开始就上视觉模型,这个服务器对得上。官方把它写成轻量 MCP 服务,给模型浏览器自动化能力,并带可选视觉模式,用来处理复杂布局和视觉元素。

适合已经安装 Node.js 18 或更新版本,并且使用 VS Code、Cursor、Windsurf 或 Claude Desktop 的人。如果你没有 Node.js 18+,或客户端不能添加 command 类型的 MCP,先不要接。

它不是只读网页摘要:浏览器自动化会启动或连接浏览器,读取无障碍树,还可能在视觉模式下处理更重的视觉信息。官方写明默认无需视觉模型、主要消耗结构化数据,但出网和本机浏览器进程都在。

3 分钟完成第一次尝试

官方推荐路径是用 npx 拉起 @agent-infra/mcp-server-browser。前置条件:本机已安装 Node.js 18 或更新版本。

在 VS Code 里,官方给出的一条命令是:

code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'

这会注册名为 browser 的 MCP,命令为 npx,参数为 @agent-infra/mcp-server-browser@latest。执行后重载客户端,确认 browser 服务已连接。

然后做一次低风险调用:使用该 browser 服务提供的浏览器自动化能力,走默认的结构化无障碍数据路径,不要打开视觉模式。官方页面没有写出具体工具名、参数或示例网址,因此只调用客户端里由这个 browser 服务列出的工具,不要自行发明未出现的工具名,也不要编造要打开的网址。成功信号是客户端显示 browser 已连接,并且返回基于无障碍树的结构化结果,而不是视觉截图。

官方另有 Cursor Settings -> MCP -> Add new MCP Server 的 command 写法,以及 --port 8089 的远程启动;第一次只走上面这条 VS Code 命令,不要并行开第二条路径。

使用案例

案例一:用默认结构化无障碍数据做浏览器自动化。官方写明它通过 Puppeteer 的结构化无障碍数据给模型浏览器能力,并且无需视觉模型、主要消耗结构化数据以降低上下文。当你要让模型理解页面上的控件和文本结构时,走这条。官方没有点名具体工具,也没有给出示例站点;调用时只使用客户端列出的、属于 browser 服务的工具,并把成功标准定为拿到结构化无障碍数据。

案例二:结构化数据不够时,再考虑可选视觉模式。官方写明视觉模式用于复杂布局和视觉元素,是可选项。官方没有写如何开启、需要什么模型、会不会落盘;因此只能确认存在可选视觉能力,不要把它当成第一次必做步骤,也不要假设它零风险。若客户端没有单独的视觉开关说明,就说明官方页面没有把开启步骤写全,停在结构化数据路径。

使用边界

前置是 Node.js 18+。官方点名的客户端是 VS Code、Cursor、Windsurf、Claude Desktop。远程启动可用 npx @agent-infra/mcp-server-browser --port 8089,也可带 DISPLAY=:0 给 VNC 或虚拟显示;这些不是第一次尝试的主路径。

浏览器自动化会出网、会控制浏览器,可能打开你指定的页面,也会在本机留下浏览痕迹。可选视觉模式在结构化数据不足时才会用到;官方没有把它写成无网络或无本地读取。

官方没有写速率限制,也没有写撤销或回滚。关掉浏览器窗口或停掉 npx 进程,是你能做的中止方式,但页面上已经发生的导航或输入,官方没有给出一键撤销。