自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

409次阅读
没有评论

共计 5953 个字符,预计需要花费 15 分钟才能阅读完成。

自己按 F12 打开 Chrome DevTools,看网络面板、控制台、性能火焰图,这件事我很熟。把同一套观察能力交给编程助手,让它自己打开页面、截图、读请求、再录一段性能追踪,就不是同一回事了。

今天 GitHub 日榜靠前的位置上,有官方仓库 ChromeDevTools/chrome-devtools-mcp。它的产品名是 Chrome DevTools for agents,npm 包名是 chrome-devtools-mcp。我在 2026-11-15 07:53(北京时间)用 GitHub API 读到 56,279 星,协议是 Apache-2.0。同一时间打开「今日」日榜,它排在第 4,页面上写着当天新增 673 星。X 上也有人把这类仓库转发一遍,我只把那些帖子当成发现入口,版本、命令和限制以官方文档和本机输出为准。

这和之前写过的 agent-browser、agent-desktop 不是一类工具:那些更接近替你点页面、控桌面。它也不是 Modern Web Guidance 那种网页最佳实践扫描器。本题要讲的是:官方把 Chrome DevTools 里做性能追踪、看网络、读控制台、截图这些能力,通过 MCP 或官方命令行,交给编程代理来用。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ GitHub 仓库 ChromeDevTools/chrome-devtools-mcp。截图来源:github.com,作者测试机,北京时间 2026-11-15 07:55。当时页面显示 56.3k stars、4.8k forks,与我用 API 读到的 56,279 星、4,759 个 fork 一致。未登录任何账号。

· · ·

PART 01

它做什么,要解决什么

按仓库 README和官网文档 Chrome DevTools for agents 的说法,这套工具让编程代理控制和检查一个正在运行的 Chrome 浏览器。它同时提供 MCP 服务和命令行工具 chrome-devtools。官方写到的能力,大致是这几类:用 DevTools 录制性能追踪,并抽出可以执行的洞察;分析网络请求;截图;查看带源码映射的控制台消息。页面操作这一侧,它用的是 Puppeteer,并且会自动等待操作结果。

Chrome 官方在 2025 年 9 月 23 日的介绍博文里,把动机写得很直白:编码代理往往看不见自己生成的代码在浏览器里实际跑成什么样。MCP 服务要补的,就是 DevTools 这一侧的眼睛。那篇博文发布时还叫 Chrome DevTools MCP server,页上现在已经注明,它已被收进 DevTools for agents。

仓库和 npm 上当前的最新正式版是 v1.13.0。GitHub Release 的发布时间是 2026-11-11 20:40(北京时间),npm 上 latest 也是 1.13.0,发布时间相差几分钟。CHANGELOG 里这一版加了 logpoints(基于 DevTools 的断点管理)、页面范围的网络 mock,以及上游网络 mock 响应。这三项我这次没有试。

🍎 三件要先知道的事。官方只正式支持 Google Chrome 和 Chrome for Testing,其他基于 Chromium 的浏览器也许能跑,但不保证。它会把浏览器实例里的内容暴露给 MCP 客户端,不适合拿已经登录了个人账号的日常浏览器做实验。另外,使用统计默认是打开的,启动时加上 --no-usage-statistics 可以关掉;这和 Chrome 浏览器自己的使用统计不是同一件事。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ 官方文档 https://developer.chrome.com/docs/devtools/agents 。截图来源:developer.chrome.com,作者测试机,北京时间 2026-11-15 07:55。用命令行新开页面后截的图,未登录。

· · ·

PART 02

自己开面板,和把能力交给命令行

自己开 DevTools,是人自己看着面板。把同一套能力接到 MCP 客户端里,是让编程助手直接调用这些工具。还有第三条路,也是我这次实际走的:不先改 Cursor 或 Claude 的配置,只用包装里的 chrome-devtools 命令,在终端里把事情做完。

官方命令行说明写:CLI 其实是后台 MCP 服务的客户端。第一次调用工具时,如果服务和浏览器还没起来,它会在后台自动拉起,后续命令复用同一实例。也可以手动 start、status、stop。文档还写,命令行界面里,无界面模式默认是打开的;只要你没有另外指定用户数据目录,隔离配置默认也是打开的。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ 示意图:自己开面板,和把 DevTools 能力交给命令行或编程助手,不是一件事。纸蓝示意,不代表真实软件界面。

我没有把 MCP 接进 Cursor、Claude 或其他编程助手里跑过,所以后面只写本机命令行里真实出现的输出。若要把服务接到助手里,官方步骤放在后面单独转述。

· · ·

PART 03

我在 Linux 上装到了 v1.13.0

测试机上的环境是:Node.js v24.22.1、npm 11.21.1、Google Chrome 156.0.8078.47(路径 /usr/bin/google-chrome-stable)。官方前置条件是 Node.js 的 LTS 版本,以及当前稳定版 Chrome。

命令行文档给出的安装示例是全局安装:

npm i chrome-devtools-mcp@latest -g
chrome-devtools status

我没有走全局安装,也没有改家里那个编程助手的配置文件,而是在一个专门的目录里执行:

npm install chrome-devtools-mcp@latest
./node_modules/.bin/chrome-devtools --version

命令输出就是一行:1.13.0。同一时刻 npm view chrome-devtools-mcp version 的结果也是 1.13.0。

启动时,我按 README 关掉了默认的使用统计,并关掉把性能追踪网址发给 CrUX 的开关;同时使用无界面、隔离用户目录,并把文件工具限制在当前项目目录:

./node_modules/.bin/chrome-devtools start \
  --no-usage-statistics \
  --performanceCrux=false \
  --headless \
  --isolated \
  --executablePath=/usr/bin/google-chrome-stable \
  --workspace="$PWD" \
  --chromeArg=--no-sandbox \
  --chromeArg=--disable-dev-shm-usage

--chromeArg=--no-sandbox 是这台 Linux 测试环境需要的参数,不应当成所有电脑都要加的默认项。启动后的提示里有一句:turning off usage statistics,说明统计已经被关掉。chrome-devtools status 回报 daemon 正在运行,version=1.13.0,参数列表里能看到 --no-usage-statistics、--no-performance-crux、--headless 和 --isolated。

在项目目录本地安装 → chrome-devtools --version 确认 1.13.0 → 带上 --no-usage-statistics 启动 → chrome-devtools status 查看是否在运行

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ 本机终端输出。来源:作者 Linux 测试机,北京时间 2026-11-15 07:54。启动命令在终端里原本是一行,截图里折行只为方便阅读;状态里的项目目录路径已改成占位。

🍎 使用统计默认是打开的。Google 会采集工具调用是否成功、耗时和环境信息,用来改进这套工具,处理方式见 Google 隐私政策。它和 Chrome 浏览器自己的使用统计相互独立:关掉浏览器的统计,不会自动关掉这里的采集。不想被采集,启动时加上 --no-usage-statistics,或设置环境变量 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS。

· · ·

PART 04

打开本地页,截图,读控制台和网络

为了让结果可以核对,我没有一上来就去打开外网示例站,而是在本机写了一个很简单的演示页:页面加载时会向同目录的 data.json 发一次请求,并在控制台写下一条日志、一条警告、一条故意的演示错误。然后用 Python 在 127.0.0.1:8765 起了一个只绑定本机的静态服务。

python3 -m http.server 8765 --bind 127.0.0.1
./node_modules/.bin/chrome-devtools new_page "http://127.0.0.1:8765/demo.html"

list_pages 显示这个演示页的编号是 2,标题是「本地演示页 · Chrome DevTools CLI 实测」。接着截图、读控制台、读网络请求,并用脚本把标题读回来:

./node_modules/.bin/chrome-devtools take_screenshot 2 --filePath demo-page.png
./node_modules/.bin/chrome-devtools list_console_messages 2
./node_modules/.bin/chrome-devtools list_network_requests 2
./node_modules/.bin/chrome-devtools evaluate_script "() => document.title" --pageId 2

截图里能看到页面已经把 data.json 的内容写出来了:请求成功,hello from local demo(true)。evaluate_script 返回的标题,和页面上的 <title> 一致。

控制台一共 5 条。前 4 条是我写在页面里的:demo page ready、this is a demo warning、this is a demo error, not a real failure,以及成功取回 data.json 的日志。第 5 条是浏览器自己要 /favicon.ico 失败,状态 404。网络请求也是 3 条:demo.html 200、data.json 200、favicon.ico 404。演示页没有放网站图标,这条 404 是真的,不是工具误报。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ 用 take_screenshot 保存的本地演示页。来源:作者测试机通过 chrome-devtools 截取,北京时间 2026-11-15 07:54。页面只在 127.0.0.1 上访问。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ list_console_messages 和 list_network_requests 的本机输出。来源:作者 Linux 测试机,北京时间 2026-11-15 07:54。

· · ·

PART 05

再录一段性能追踪

命令行里有 performance_start_trace。我在已经打开的演示页上跑了这条命令,让它重新加载页面并自动结束录制,原始追踪存成 demo-trace.json.gz:

./node_modules/.bin/chrome-devtools performance_start_trace 2 --reload true --autoStop true --filePath demo-trace.json.gz

命令成功结束,文件大小是 91,903 字节。摘要里这次导航的实验室指标是:LCP 83 毫秒(其中 TTFB 2 毫秒,渲染延迟 81 毫秒),CLS 0.00。字段数据写的是:这个页面在 CrUX 里没有数据。这说得通。它只是本机上的一个小页,我启动时也已经关掉了向 CrUX 发送追踪网址。

这些数字说明不了「这个工具让页面变快了」,也不适合拿去代表真实网站的成绩。它能说明的只有一件事:命令行确实调用了 DevTools 的性能追踪,并给出了一份能对上这个本地页的摘要。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ performance_start_trace 摘要。来源:作者 Linux 测试机,北京时间 2026-11-15 07:54。追踪文件路径在截图里写成了文件名,实际保存在测试目录。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ 示意图:这次在命令行里实际走通的几步。纸蓝示意,不代表真实软件界面。

· · ·

PART 06

如果要把 MCP 接进编程助手

我没有在 Cursor 或 Claude 里做过这一步,下面只转述官方写的步骤。

入门文档和仓库 README 写的通用配置是:在 MCP 客户端里加入下面这段。@latest 的意思是客户端每次都会去拉当前最新版。

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

如果要关掉使用统计,官方 README 的写法是在 args 里追加 "--no-usage-statistics"。

针对 Cursor,客户端配置说明写的步骤是:打开 Cursor Settings → MCP → New MCP Server,使用上面这份标准配置;页面上也提供了一键安装按钮。Claude Code、Gemini CLI、Copilot 各有对应的命令或插件装法,以那份说明为准。官方给的一句测试提示词是:Check the performance of https://developers.chrome.com。我没有在任何助手里发出过这句。

还有一种更危险的用法:连到已经打开、甚至已经登录的 Chrome。2025 年 12 月 11 日的官方博文介绍了 --autoConnect:要先在 chrome://inspect/#remote-debugging 打开远程调试,浏览器还会弹出允许对话框,并且在会话期间显示被自动化软件控制的横幅。官方自己也写了,连上现有会话就等于把登录态、cookie 和其他数据交给代理。这条路我没有试。

自己按 F12,和把 Chrome DevTools 交给编程助手,不是一件事

▲ 示意图:启动时可以关掉使用统计;也不要把已经登录的日常浏览器随手交给 MCP 客户端。纸蓝示意,不代表真实软件界面。

测完后,用 chrome-devtools stop 停掉后台服务。本地那个只绑定 127.0.0.1 的静态服务我也关掉了。

· · ·

这次跑通的是命令行,不是「助手已经替我修好了一个线上页面」。v1.13.0 新加的 logpoints 和网络 mock,我没有覆盖。适合先在隔离目录、无界面、不带个人登录态的 Chrome 里看工具到底能返回什么;若要把 MCP 接进自己的编程助手,按官方文档加配置即可,但记得把使用统计关掉,也别把日常浏览器交出去。

相关阅读:让 AI 自己开网页、点按钮:agent-browser 实测、用 agent-desktop 替 AI 点了一早上计算器、用 Modern Web Guidance 本地扫一份旧留言页。

正文完
 0

版权声明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。

科技喵仔
版权声明:本站原创文章,由 科技喵仔 于2026-11-15发表,共计5953字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)
验证码
    中文English