BrowserTools MCP 教程

按 AgentDeskAI/browser-tools-mcp README 走一遍。跑通标准：当前调试页开着 DevTools，Agent 能拉到 console / network。这是给编码 Agent 看你正在看的页，不是替你点完整流程。需要 Node 22.19+（本机 v26.7.0 通过 doctor）。

本机已 npx @agentdeskai/browser-tools-mcp@latest --doctor：Version 2.0.2，Connector 听在 127.0.0.1:3025，Chrome extension not connected。已用 Chrome 打开 chrome://extensions。文件选择器（Load unpacked）需要你本地点目录。

1. 写 MCP 配置

Cursor MCP 里粘贴（官方强调用 2.0，1.x 有严重漏洞；没有第二台 server 要另起）：

{
  "mcpServers": {
    "browser-tools": {
      "command": "npx",
      "args": ["-y", "@agentdeskai/browser-tools-mcp@latest"]
    }
  }
}

本机 doctor 原文：扩展未连上时会提示 Open Chrome DevTools (F12)… load the extension from the chrome-extension directory。

2. 加载 Chrome 扩展

1. 下载或 git clone https://github.com/AgentDeskAI/browser-tools-mcp.git
2. Chrome 地址栏输入 chrome://extensions 回车
3. 打开右上角 开发者模式
4. 点 加载已解压的扩展程序，选仓库里的 chrome-extension 目录（里面有 manifest.json、devtools.html）

本机打开扩展页时开发者模式默认是关的，列表是空的——先打开开关再 Load unpacked：

3. 跑通一次

在要调试的页面按 F12。采集从 DevTools 打开那一刻开始（不必点进 BrowserTools 面板）。然后问 Agent：check the console for errors。不工作再跑：

npx @agentdeskai/browser-tools-mcp@latest --doctor

4. 翻车点

DevTools 打开之前的请求不会被记下，要完整加载请刷新。Chrome 会显示 “started debugging this browser” 横幅，面板里可改成 Wrap page console。Firefox 官方未验证。不要把它当成 Playwright MCP 那种自动点测。

出处：README