Chrome DevTools for agents 浏览器调试与自动化

Chrome DevTools for agents：安装说明

这个工具包里只有安装说明，由 Mindket 编写。MCP 服务器、命令行工具和技能都来自制作者的仓库和它的 npm 包：https://github.com/ChromeDevTools/chrome-devtools-mcp

这些说明不是它的制作者写的，也没有得到它的认可。README 说，Chrome DevTools for agents（chrome-devtools-mcp）“lets your coding agent (such as Antigravity, Claude, Cursor or Copilot) control and inspect a live Chrome browser.”，意思是让你的编程智能体（比如 Antigravity、Claude、Cursor 或 Copilot）控制并检查一个正在运行的 Chrome 浏览器。它既是 MCP 服务器，也是命令行工具。工具参考和其他文档在仓库的 docs 文件夹里：https://github.com/ChromeDevTools/chrome-devtools-mcp/tree/main/docs

许可证：Apache-2.0。GitHub 写的是它，npm 的 package.json 写的也是 Apache-2.0，LICENSE 文件（https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/LICENSE）是标准的 Apache License 2.0 文本。它唯一的版权行 [yyyy] [name of copyright owner] 在附录的使用模板里，那是标准文本的一部分。package.json 把作者写作 Google LLC。

会装上什么

• chrome-devtools-mcp 这个 npm 包，里面有 MCP 服务器和 chrome-devtools 命令行工具。大多数客户端用 npx -y chrome-devtools-mcp@latest 按需运行它，所以不用全局安装。来源：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/README.md
• 你的智能体 MCP 配置里的一条记录，用来启动这条命令。
• 可选：包里 skills 文件夹中的技能，或者把 MCP 服务器和技能打包在一起的插件。README 列了七个：chrome-devtools、chrome-devtools-cli、a11y-debugging、cookie-debugging、debug-optimize-lcp、memory-leak-debugging 和 troubleshooting。
• 不带 Chrome。服务器启动你已有的 Chrome，或者连上你自己启动的那个。Chrome 会保留一个配置档案文件夹，setup/connect-to-your-chrome.md 里有说明。

先准备好什么

• Node.js，当前的 LTS 版本。README 写的是“Node.js LTS version”，package.json 的 engines 字段是 ^20.19.0 || ^22.12.0 || >=23。来源：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/README.md
• Chrome，“current stable version or newer”（当前稳定版或更新的版本），以及 npm。来源：README.md 的 Requirements 一节。
• 官方支持的浏览器是 Google Chrome 和 Chrome for Testing。README 说其他基于 Chromium 的浏览器也许能用，但不保证。
• 不需要账号，也不需要 API 密钥。README 的设置步骤都没有要求。

主要的安装命令

把下面这段加进你的 MCP 客户端配置。客户端配置指南给大多数客户端指向的都是这份“标准配置”。

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

来源：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/README.md 的 Getting started 一节。README 补充说，@latest 让客户端始终使用最新版的服务器。

第一条提示词

要检查它能不能用，README 让你在 MCP 客户端里输入：

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

客户端应该会打开浏览器并录制一份性能追踪。浏览器在客户端第一次用到需要它的工具时才启动。光连上服务器，不会启动浏览器。

智能体能用到什么

工具参考（https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/tool-reference.md）按用途给工具分了组。有些组需要一个参数。

• 输入自动化：click、drag、fill、fill_form、handle_dialog、hover、press_key、type_text、upload_file，以及需要 --experimentalVision=true 的 click_at
• 导航：close_page、list_pages、navigate_page、new_page、select_page、wait_for
• 模拟：emulate、resize_page
• 性能：performance_start_trace、performance_stop_trace、performance_analyze_insight
• 网络：list_network_requests、get_network_request
• 调试：evaluate_script、list_console_messages、get_console_message、get_css_styles、lighthouse_audit、take_screenshot、take_snapshot、screencast_start、screencast_stop
• 内存：take_heapsnapshot，以及堆快照分析工具，比如 compare_heapsnapshots，分析工具需要 --memoryDebugging=true。
• 扩展、第三方开发者工具、WebMCP、渐进式网页应用（PWA）和 WebAuthn：每一组默认关闭，要把对应的 --category... 参数设成 true 才开。

各个智能体的说明

• setup/claude-code.md：只装 MCP 的命令，以及带技能的插件
• setup/codex.md：codex mcp add 命令和 Windows 11 的配置
• setup/gemini-cli.md：只装 MCP 的命令和 Gemini 扩展
• setup/cursor.md
• setup/github-copilot-and-vs-code.md：插件、MCP 服务器、VS Code 命令行和 Copilot CLI
• setup/antigravity.md
• setup/other-agents.md：Amp、Bob、Cline、Command Code、Devin CLI、Factory CLI、Gemini Code Assist、Grok Build CLI、JetBrains、Kiro、Mistral Vibe、OpenCode、Pi、Qoder、Qoder CLI、Warp、Windsurf、Katalon Studio 和 FLUJO。Visual Studio 在 Copilot 那一页里。
• setup/connect-to-your-chrome.md：用一个你已经在运行的 Chrome，或者一台 Android 手机上的 Chrome
• setup/options-and-privacy.md：使用统计、CrUX、更新检查，以及多数人会改的参数
• setup/cli-and-skills.md：chrome-devtools 命令行工具和智能体技能
• setup/troubleshooting.md

更新或移除

README 说，标准配置里的 chrome-devtools-mcp@latest 让你的客户端始终使用最新版的服务器。如果你全局装了命令行工具，README 给的是：

npm i chrome-devtools-mcp@latest -g

技能描述的是某一个版本的工具。README 说，每次更新服务器或命令行工具，都要把技能一起更新：插件用你的智能体的插件管理器更新，手动复制的就再复制一遍文件夹。步骤在 setup/cli-and-skills.md 里。

README 和文档都没有给卸载步骤。要手动卸载的话，这些说明（是 Mindket 写的，不是制作者写的）的做法是：从客户端的 MCP 配置里删掉 chrome-devtools 这一条，删掉插件或你复制过的技能文件夹，如果是用 -g 全局安装的，再用 npm 卸载全局的 chrome-devtools-mcp 包。setup/connect-to-your-chrome.md 写明了服务器保留的配置档案文件夹，它会一直留着，直到你删掉它。

使用数据和对外连接

README 说，Google 会收集使用统计，“such as tool invocation success rates, latency, and environment information”（比如工具调用的成功率、延迟和环境信息），而且默认开启。传 --no-usage-statistics 可以关掉，设置 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI 环境变量也会关掉。性能工具还可能把追踪里的 URL 发给 Google 的 CrUX API，--no-performance-crux 可以停掉。服务器会去 npm 仓库检查更新，除非设置了 CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS。setup/options-and-privacy.md 里有这三项和各自的来源。

README 还警告说，服务器会把浏览器实例里的内容暴露给 MCP 客户端，客户端可以查看、调试和修改浏览器或 DevTools 里的任何数据。不想让客户端看到的信息，不要分享出去。

来源

• README：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/README.md
• Client configurations：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/client-configurations.md
• Configuration：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/configuration.md
• Advanced usage：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/advanced-usage.md
• CLI：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/cli.md
• Tool reference：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/tool-reference.md
• Slim tool reference：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/slim-tool-reference.md
• Troubleshooting：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/troubleshooting.md
• Design principles：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/design-principles.md
• package.json：https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/package.json