用途
chrome-devtools-mcp 是 Chrome DevTools 官方提供的 MCP（Model Context Protocol）服务器，目标是让 AI 编程代理（coding agent）能够控制并检查一个正在运行的 Chrome 浏览器。它把 Chrome DevTools 的能力开放给 AI 编码助手，用于可靠的自动化、深度调试和性能分析。官方说明中提到的适用代理包括 Antigravity、Claude、Cursor、Copilot 等。除 MCP 服务器外，项目还提供 CLI，可在不使用 MCP 的情况下使用。
主要能力
- 性能洞察：使用 Chrome DevTools 录制 trace，并提取可执行的性能洞察。
- 高级浏览器调试：分析网络请求、截取屏幕截图、查看浏览器控制台消息（带 source map 的堆栈跟踪）。
- 可靠自动化：使用 puppeteer 在 Chrome 中自动执行操作，并自动等待操作结果。
官方说明指出，chrome-devtools-mcp 会把浏览器实例的内容暴露给 MCP 客户端，使其能够检查、调试和修改浏览器或 DevTools 中的任何数据，因此应避免共享不希望暴露给 MCP 客户端的敏感或个人信息。
使用方式
在 MCP 客户端中添加配置即可使用。官方建议使用 chrome-devtools-mcp@latest，以确保 MCP 客户端始终使用最新版本。如果只做基础浏览器任务，可使用 --slim 模式。针对不同编辑器或代理（如 Antigravity、Claude Code、Cursor、VS Code）的具体设置，官方提供了 Client Configurations Guide。
首次验证时，可在 MCP 客户端输入提示词，客户端应打开浏览器并录制性能 trace。MCP 服务器会在 MCP 客户端使用需要运行中浏览器实例的工具时自动启动浏览器；仅连接到 Chrome DevTools MCP 服务器本身不会自动启动浏览器。
服务器参数（如 --headless、--isolated、--slim）以及 WebSocket 连接配置见官方 Configuration Guide。并发会话、持久化用户数据目录、连接到已运行的 Chrome 实例而非启动新实例、Android 调试等高级功能见 Advanced Usage Guide。
如果正在开发代理工具并希望在产品中提供集成的浏览器子代理，官方建议基于 Chrome DevTools for agents 构建，参考实现见 Gemini CLI browser agent 文档。
适用场景
- AI 编程代理需要检查、调试或修改浏览器中的页面与数据。
- 需要录制性能 trace 并获取性能洞察。
- 需要分析网络请求、截图、查看控制台日志与堆栈跟踪。
- 需要基于 puppeteer 的浏览器自动化并自动等待结果。
- 开发代理工具时，作为集成浏览器子代理的基础。
限制与注意事项
- 官方仅支持 Google Chrome 和 Chrome for Testing；其他 Chromium 内核浏览器可能可用，但不保证，可能出现意外行为，需自行判断。官方承诺为最新版 Extended Stable Chrome 提供修复和支持。
- 性能工具可能将 trace URL 发送至 Google CrUX API 以获取真实用户体验数据，从而在实验室数据之外提供现场数据；可用 --no-performance-crux 标志关闭。
- 默认收集使用统计数据（如工具调用成功率、延迟、环境信息），用于改进可靠性和性能；可用 --no-usage-statistics 标志关闭。设置 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI 环境变量时也会禁用收集。该统计收集独立于 Chrome 浏览器的使用统计，退出其一不会自动退出另一项。
- 默认情况下服务器会定期检查 npm registry 是否有更新，并在有新版本时记录通知；可通过设置 CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS 环境变量禁用更新检查。
- 运行环境要求：Node.js LTS 版本；Chrome 当前稳定版或更新版本。
- 由于会向 MCP 客户端暴露浏览器内容，需注意敏感或个人信息的安全。
