浏览器与测试 · Chrome DevTools 官方仓库

Chrome DevTools MCP

把 Chrome DevTools 的页面、网络与性能诊断能力提供给编码助手。

CodexClaude Codestdio
已核验查看接入方法 支持 Codex、Claude Code 等平台

Chrome DevTools MCP 是什么?

Chrome DevTools MCP 是把 Chrome 调试能力开放给编码助手的本地 MCP 服务器。它让 Codex 读取页面、控制台、网络请求和性能记录,用浏览器证据排查前端问题。

一句话理解把 Chrome DevTools 的页面、网络与性能诊断能力提供给编码助手。

为什么需要它?

让浏览器问题从截图猜测转为页面、网络和性能证据驱动的诊断。

接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。

核心能力

01
连接 Chrome 页面并读取调试信息

把真实信息带回当前任务,减少反复复制和手动核对。

02
检查网络、控制台和性能记录

在明确授权范围内调用工具,并保留执行过程和结果。

03
执行页面交互与截图辅助复现

回读来源、状态与限制,方便继续处理和人工验收。

适合谁?怎么用?

适合使用
  • 排查前端控制台、网络和性能问题
  • 需要排查前端性能、网络请求、控制台异常和渲染行为的开发者。
  • 能指出具体 URL、请求状态或错误堆栈,而不是只凭截图猜原因。
不适合
  • 不适合连接含账号、Cookie、支付或客户数据的日常浏览器。
  • 可读取页面、网络请求和浏览器调试数据
  • 连接日常浏览器可能暴露 Cookie、表单和账号状态

怎么接入?

  1. 1
    准备

    确认本机 Chrome、Node.js 与 npx 可用。

  2. 2
    授权

    按官方 README 用 npx -y chrome-devtools-mcp@latest 登记 stdio 服务。

  3. 3
    连接

    使用独立调试配置并确认遥测选项。

  4. 4
    开始使用

    连接无敏感登录态页面并读取控制台。

安装命令

添加 Chrome DevTools MCP

codex mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest

在终端运行。先用无敏感登录态的测试页面验证,不要直接连接日常浏览器。

检查命令

确认 MCP 已经登记

codex mcp list

接入前准备

  • 本机 Chrome 与 Node.js 运行环境
  • 独立调试配置或明确允许的页面
  • 了解仓库默认使用统计及关闭选项

官方帮助

官方文档与仓库Chrome DevTools 官方仓库问题反馈在 GitHub Issues 获取帮助

第一次调用示例

登记完成后,新开一个任务,先用下面这句做只读验证,把目标、范围和停止条件一次说清楚。

发给 Codex

第一次只读任务

请用 Chrome DevTools MCP 检查这个页面的控制台错误、失败请求和 LCP 线索,只读返回证据。
怎样算成功

能指出具体 URL、请求状态或错误堆栈,而不是只凭截图猜原因。

  1. 先检查页面、控制台和网络摘要。
  2. 定位具体请求或性能记录。
  3. 修复后重新加载并比较证据。
  4. 保存必要日志,不保存 Cookie 或敏感请求体。

权限与安全

凭证与连接方式

本地 stdio;使用独立调试配置,并单独确认遥测设置。

  • 可读取页面、网络请求和浏览器调试数据
  • 连接日常浏览器可能暴露 Cookie、表单和账号状态
  • 使用统计默认状态应在团队隐私规则下单独确认

用小贺API和 MCP,把真实工具接进工作流

从一个 MCP、一个只读任务开始,先把连接、权限和结果验证清楚。

多平台支持兼容主流 MCP 客户端接入方法清楚命令与自助指令分开权限边界明确先只读再扩大范围
进入小贺API