chrome-devtools-mcp — AI 浏览器调试与自动化 MCP 工具
chrome-devtools-mcp 是 Google Chrome DevTools 团队官方出品的 MCP 服务器，通过 Model Context Protocol 让 AI 编码助手获得完整的 Chrome DevTools 能力。它使用 Puppeteer 实现可靠的浏览器自动化，内置等待机制确保操作结果正确。支持 Claude Code、Cursor、VS Code Copilot、Codex 等主流 AI 工具，是 AI 驱动前端调试和 Web 自动化的首选方案。
核心使用场景
- 前端 Bug 调试：AI 直接打开页面、查看控制台报错（含源码映射的堆栈追踪）、检查网络请求
- 性能分析：录制页面性能 Trace、提取可操作的优化建议，结合真实用户数据（CrUX）
- 截图与视觉验证：AI 截图当前页面状态，辅助 UI 回归测试和 Bug 复现
- Web 自动化测试：AI 填写表单、点击按钮、导航页面，可靠等待操作完成
- 接入已有 Chrome 实例：连接 DevTools 远程调试端口，调试任意 Chrome 标签页
AI 辅助使用流程
- 安装配置 — AI 在 Claude Code 中执行一行命令完成 MCP 服务器安装
- 连接浏览器 — 服务器自动启动 Chrome，或连接指定的 DevTools 远程端口
- 导航目标页面 — AI 通过 MCP 工具导航到待调试的 URL
- 执行调试操作 — AI 截图、检查控制台、分析网络请求、录制性能 Trace
- 自动化交互 — AI 自动化点击/填写/滚动等用户操作
- 分析结果 — AI 基于 DevTools 数据给出优化建议或 Bug 定位
关键章节导航
- 安装指南 — Claude Code / VS Code / Cursor 多种安装方式
- 快速开始 — 调试工作流、截图、性能分析、网络检查
- 高级用法 — 连接已有浏览器、Slim 模式、隐私配置
- 故障排查 — 浏览器连接失败、超时、权限问题
AI 助手能力
使用本技能时，AI 可以：
- ✅ 通过
claude mcp add 或 /plugin install 完成 MCP 服务器安装 - ✅ 导航到任意 URL 并等待页面加载完成
- ✅ 截图当前页面状态（支持全页面 / 视口截图）
- ✅ 读取浏览器控制台消息（含源码映射的完整堆栈追踪）
- ✅ 检查网络请求（URL / 状态码 / 响应头 / 响应体）
- ✅ 录制性能 Trace 并提取关键性能指标
- ✅ 执行点击、填写表单、键盘输入等自动化操作
- ✅ 执行任意 JavaScript 代码并获取返回值
核心功能
- ✅ 截图 — 全页面或视口截图，辅助视觉 Bug 复现
- ✅ 控制台检查 — 读取 log/warn/error 消息，含源码映射堆栈
- ✅ 网络分析 — 拦截和检查所有 HTTP/HTTPS 请求
- ✅ 性能分析 — 录制 DevTools Trace，结合 CrUX 真实用户数据
- ✅ 浏览器自动化 — 基于 Puppeteer 的可靠点击/填写/导航
- ✅ JavaScript 执行 — 在页面上下文中执行任意 JS
- ✅ Slim 模式 — 精简工具集，适合基础浏览任务
- ✅ 无头模式 —
--headless 支持 CI 环境 - ✅ 远程连接 — 连接已有 Chrome DevTools 远程调试端口
- ✅ 多 AI 工具 — Claude Code / Cursor / VS Code / Copilot / Codex
快速安装示例
# Claude Code CLI 安装（推荐）
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
# Claude Code 插件安装（含 Skills）
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp
# VS Code CLI 安装
code --add-mcp '{"name":"chrome-devtools","command":"npx","args":["-y","chrome-devtools-mcp"]}'
MCP 配置（手动添加到 settings.json）：
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
安装要求
| 依赖 | 版本要求 |
|---|
| ------ | --------- |
| Node.js | >= 20.19（最新 LTS 维护版） |
| Chrome | 当前稳定版或更新 |
| npm | 任意版本 |
项目链接
- GitHub：https://github.com/ChromeDevTools/chrome-devtools-mcp
- 工具参考：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/tool-reference.md
- Slim 工具参考：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/slim-tool-reference.md
- 故障排查：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/troubleshooting.md