面向 Agent 的 Chrome DevTools

面向 Agent 的 Chrome DevTools（chrome-devtools-mcp）让你的编码助手（例如 Antigravity、Claude、Cursor 或 Copilot）能够控制并查看一个真实运行的 Chrome 浏览器。它作为一个模型上下文协议（Model-Context-Protocol，MCP）服务器运行，让你的 AI 编程助手获得 Chrome DevTools 的完整能力，从而实现可靠的自动化、深入的调试以及性能分析。同时也提供了一个[命令行工具（CLI）][cli]，可以在不使用 MCP 的情况下使用。

[工具参考][tool-reference] | [更新日志][changelog] | [贡献指南][contributing] | [故障排查][troubleshooting] | [设计原则][design-principles]

主要特性

获取性能洞察：使用 Chrome DevTools 录制 trace，并提取可操作的性能洞察。
高级浏览器调试：分析网络请求、截取屏幕截图，并查看浏览器控制台消息（包含已还原 source map 的堆栈信息）。
可靠的自动化：基于 puppeteer 在 Chrome 中自动执行操作，并自动等待操作结果。

免责声明

chrome-devtools-mcp 会将浏览器内的数据暴露给 MCP 客户端，使其能够查看、调试和修改浏览器或 DevTools 中的任何数据。请避免共享你不希望被 MCP 客户端获取的敏感或个人信息。

chrome-devtools-mcp 官方仅支持 Google Chrome 和 Chrome for Testing。其他基于 Chromium 的浏览器或许可以工作，但不作保证，并且你可能遇到意料之外的行为。请自行斟酌使用。我们承诺针对最新版 Extended Stable Chrome 提供修复与支持。

性能工具可能会将 trace 的 URL 发送给 Google CrUX API，以获取真实用户体验数据。这有助于在展示实验室数据的同时呈现线上（现场）数据，从而提供更全面的性能视图。这些数据由 Chrome User Experience Report (CrUX) 收集。若要禁用此行为，请使用 --no-performance-crux 参数运行。

使用情况统计

Google 会收集使用情况统计数据（例如工具调用成功率、延迟以及环境信息），以提升 Chrome DevTools MCP 的可靠性与性能。

数据收集默认开启。你可以在启动服务器时传入 --no-usage-statistics 参数以选择退出：

"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Google 按照 Google 隐私政策处理这些数据。

Google 针对 Chrome DevTools MCP 所收集的使用情况统计与 Chrome 浏览器自身的使用情况统计相互独立。退出 Chrome 的指标收集并不会自动退出本工具的收集，反之亦然。

如果设置了 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI 环境变量，数据收集将被禁用。

更新检查

默认情况下，服务器会定期检查 npm registry 中的更新，并在有可用新版本时记录一条通知信息。你可以通过设置 CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS 环境变量来禁用这些更新检查。

环境要求

Node.js LTS 版本。
Chrome 当前稳定版或更新版本。
npm

快速开始

将以下配置添加到你的 MCP 客户端：

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

[!NOTE]
使用 chrome-devtools-mcp@latest 可确保你的 MCP 客户端始终使用 Chrome DevTools MCP 服务器的最新版本。

如果你仅需完成一些基础的浏览器任务，可以使用 --slim 模式：

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

请参阅 [Slim 模式工具参考][slim-tool-reference]。

MCP 客户端配置

针对特定编辑器或 Agent（例如 Antigravity、Claude Code、Cursor、VS Code）的配置说明，请参阅我们的[客户端配置指南][client-configurations-guide]。

你的第一条提示

在你的 MCP 客户端中输入以下提示，以检查一切是否正常工作：

Check the performance of https://developers.chrome.com

你的 MCP 客户端应该会打开浏览器并录制一条性能 trace。

[!NOTE]
一旦 MCP 客户端调用了需要运行中的浏览器的工具，MCP 服务器就会自动启动浏览器。仅连接 Chrome DevTools MCP 服务器本身并不会自动启动浏览器。

工具

如果遇到任何问题，请查阅我们的[故障排查指南][troubleshooting]。

完整的[工具参考][tool-reference]中列出了所有受支持的 MCP 功能。

配置

完整的服务器参数列表（例如 --headless、--isolated、--slim）以及 WebSocket 连接的配置方法，请参阅[配置指南][configuration-guide]。

进阶用法

有关进阶功能（例如处理并发会话、持久化的用户数据目录、连接到已运行的 Chrome 实例而非启动新实例，以及在 Android 上进行调试），请参阅我们的[进阶用法指南][advanced-usage-guide]。

作为浏览器子 Agent 进行集成

如果你正在开发 Agent 类工具，并希望在你的产品中提供一个集成的浏览器子 Agent，我们建议基于「面向 Agent 的 Chrome DevTools」进行构建。

参考实现请参阅 Gemini CLI 浏览器 Agent 文档。

ChromeDevTools/chrome-devtools-mcp

AI智能总结