太狠了!GitHub 5.6 万 Star,让 AI 直接操控 Chrome 调试

今天聊一个项目:chrome-devtools-mcp,想必已经有很多人都知道这个项目了。
它出自 Google 官方的 ChromeDevTools 组织,Chrome DevTools 和 Puppeteer 都归这个团队管,2025 年 9 月开源,一年多 star 攒到 5.6 万。
它干的事很简单,一句话概括:把 Chrome DevTools 的整套调试能力包成 MCP 服务器,让AI Agent直接连上一个真的 Chrome,替你查请求、翻 console、录性能 trace。
这个项目,你只需要记住几个关键信息即可。
- 项目:
chrome-devtools-mcp,官方名Chrome DevTools for agents - 出品:ChromeDevTools 组织,Chrome DevTools 面板和 Puppeteer 的官方维护方
- Star:56390(截至 2026-11-15),2025 年 9 月开源,最新版 v1.13.0 上周刚发
- 技术栈:TypeScript + Puppeteer + Chrome DevTools Protocol,npm 一个包,MCP 服务器和 CLI 两种用法
- License:Apache-2.0

用 AI 写前端的人,最该装这个
用 AI 写过前端的人都熟这个循环。Agent 写完一个页面,跑起来白屏,你自己打开 DevTools,看 console 里的报错,看 Network 里哪个请求红了,复制报错贴回对话框,等它改,改完再跑,再贴。
这些调试信息Agent全都看不到,只能凭代码猜。你来回复制粘贴报错信息,一次白屏排查下来,对话能刷几十轮。
chrome-devtools-mcp 把 DevTools 直接递到 Agent 手里。装好之后一句话派活,官方文档给的三个例子。
打开 developer.chrome.com 的手机版,点开汉堡菜单,检查顶级导航项全不全
把位置模拟到柏林,看门店定位页能不能找到 Rosenthaler Strasse 那家店
跑一次 Lighthouse 无障碍审计,把对比度不够的元素列出来,给出修复建议
这些活Agent自己开浏览器、自己点、自己看结果,干完交一份报告。你只管验收。

50 多个工具,按 Agent 能干的事分三层
Chrome DevTools MCP 打包了 50 多项能力,按 Agent 职责拆成三层:
- 第一层是浏览器交互底座,让 Agent 可以打开页面、点击输入、模拟手机 / 弱网等各种访问环境;
- 第二层是诊断采集层,把 DevTools 的网络、Console、性能、内存、样式面板全部开放给 Agent 采集数据;
- 第三层是上层决策编排,Agent 基于浏览器里真实运行信息,自主复现 bug、定位前端问题,联动代码 Agent 完成修复验证。

除了50+工具,还内置了7个Skill
Chrome DevTools MCP 除了 50+ 原子工具(Tool),还内置了 7 个 Skill。

简单区分:Tool 是一个个可调用的底层动作;Skill 是给 Agent 预置好的专项排查流程与策略方法,告诉 Agent 遇到某一类问题时,该按什么顺序调用工具、怎么解读结果。
| Skill 名称 | 核心作用 | 典型用途 / 适用场景 |
|---|---|---|
| chrome-devtools | 通用调试主入口,是默认 Skill,提供基础浏览器操作、页面观测能力 | 页面报错复现、UI 自动化、查看网络请求、DOM 检查、截图、Lighthouse 通用审计,绝大多数前端调试场景优先使用 |
| chrome-devtools-cli | 指导 Agent 生成可复用的 CLI 命令脚本,把浏览器操作封装成命令行 | CI 流水线自动化、批量任务、输出可直接在终端执行的调试脚本 |
| a11y-debugging | 无障碍专项调试,引导 Agent 调用 DevTools 无障碍面板做合规检查 | WCAG 无障碍验收、ARIA 属性校验、对比度、焦点管理、屏幕阅读器兼容问题排查 |
| cookie-debugging | 聚焦 Cookie、前端存储、会话鉴权相关的观测与修改 | 登录态丢失、跨域 SameSite Cookie 问题、LocalStorage/SessionStorage 调试、鉴权 Token 异常 |
| debug-optimize-lcp | LCP(最大内容绘制)专项性能排查,录制性能 Trace 定位瓶颈 | 首屏加载慢、Core Web Vitals 指标优化、图片 / 字体 / 服务端响应阻塞分析、SEO 体验优化 |
| memory-leak-debugging | JS 内存泄漏诊断,指导抓取、对比堆快照,定位泄漏对象 | SPA 页面切换内存持续上涨、页面长时间运行卡顿、detached DOM、事件监听未释放等问题(需要开启 --memoryDebugging) |
| troubleshooting | MCP 自身连接故障自检,排查 Chrome 和 MCP 服务之间的连通问题 | MCP 连不上 Chrome、attach 失败、调用超时、浏览器启动参数 / 端口 / 权限异常排查 |
7 个 Skill 不是独立安装包,它们是随 chrome-devtools-mcp 一起打包内置的,不需要一个个单独下载安装。
但分两种接入模式:
- 只装 MCP 服务(只有 50 + 底层 Tool,不带 Skill );
- 安装 Plugin 模式(MCP 服务 + 全部 7 个 Skill 一起加载,Agent 才能读到这些调试流程)。
另外有个别专项能力,需要加启动 Flag 解锁配套工具。
一条配置接进你的 Agent
环境门槛两条,Node.js 的 LTS 版本,加一个当前稳定版 Chrome。MCP 客户端配置里加一段
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
如果你要开启内存泄漏 Skill 配套的内存快照工具,需要追加 --memoryDebugging 参数:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": [
"-y",
"chrome-devtools-mcp@latest",
"--memoryDebugging"
]
}
}
}
注意:JSON 原生配置方式默认是纯 MCP,不带 Skill;想要 Skill 优先用下面 Plugin 方式。
用 Claude Code 的可以走插件装,MCP 和 skill 一次带上
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins
Codex 用户一行命令
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
配好丢一句 prompt 验证
Check the performance of https://developers.chrome.com
Agent 调用第一个工具时 Chrome 自动拉起,录一份性能 trace,跑完给优化建议。看到浏览器自己弹出来那一刻,就算通了。
这个 npm 包里其实装了两个形态,MCP 服务器之外还有个 chrome-devtools CLI,不想接Agent也能在终端直接使
npm i chrome-devtools-mcp@latest -g
chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
chrome-devtools take_screenshot 1 --filePath screenshot.png
chrome-devtools stop
工具太多嫌乱,启动加 --slim,只留基础操作那组。新手上手记两组就够,navigate 和截图用来跑通流程,console 和 network 用来排查 bug,性能和内存那批,用到再查文档不迟。

用之前,两件事得知道
一是浏览器内容会全量暴露给 MCP 客户端,Agent 能看到这个 Chrome 实例里的任何数据和页面。别拿你登着公司后台、存着密码的日常 Chrome 去连,官方 disclaimer 写得很直白。浏览器支持也只保证 Google Chrome 和 Chrome for Testing,其他 Chromium 系浏览器可能能跑,出了问题别找官方。
二是默认收集使用统计,工具调用的成功率、耗时这类数据会回传 Google,想关就在启动参数加 --no-usage-statistics。
性能工具还会把 trace 的 URL 发给 Google 的 CrUX API 拉真实用户数据,介意的话加 --no-performance-crux。
写在最后
这类工具的取舍很清楚。天天让AI Agent写前端、调试来回贴报错贴到烦的,接上省的是实打实的时间;偶尔改改静态页的,装不装都行。
就算不装,有两个思路值得带走。给 Agent 配的工具,别只停留在「能操作」,「能看到结果」才更实用,能读到 console、网络、trace 的 Agent 和只会点页面的 Agent,干出来的活差得远。
还有官方团队把自己面板的分析引擎包成 MCP 工具给到 Agent 这个做法,各家有专业积累的团队其实都能照此把自己最实用可复用的能力开放出来,这事本身比任何一个具体工具都值得推荐。
两个链接放这,感兴趣的自己看。
项目地址:
https://github.com/ChromeDevTools/chrome-devtools-mcp
官方文档:
https://developer.chrome.com/docs/devtools/agents

浙公网安备 33010602011771号