Chrome DevTools MCP
让编码智能体直接操控 Chrome，完成自动化、调试与性能分析。
证据显示项目支持 MCP roots、路径校验、符号链接写入防护以及可选 URL 允许/阻止规则，并用测试覆盖多项边界；但临时目录始终可访问，网络规则并非完整沙箱，且浏览器控制能力本身很广，因此最小权限未获满分。服务器把工具调用及参数验证责任明确交给客户端，未展示内建的逐操作用户确认，故确认项为 0。README 充分披露浏览器内容暴露、默认启用的使用统计、CrUX 查询、更新检查及退出方式，数据流透明度可获满分。敏感数据有明确警告和关闭遥测的机制，但遥测默认开启、浏览器数据可被客户端读取，且 WebSocket 头可携带凭据，未展示专门的秘密遮蔽或最小化措施。依赖版本、npm 脚本限制、锁定提交的 Actions 和发布前验证体现了供应链防护，但普通依赖仍有范围版本，且所给材料没有漏洞扫描或已知漏洞处置证据。写文件、安装扩展、导航和页面修改等外部效果被清楚记录，却没有统一确认门；隔离配置和部分关闭/卸载能力只提供有限恢复，不能回滚一般页面或文件副作用。仓库、作者和许可证归属明确，但发布者未被企业注册表验证，且材料不足以独立确认发布身份。
README、配置、包元数据及测试对页面标识、重连、快照、结构化输出、超时调整和资源访问表现出较强的一致性，因此自洽性获满分。Node、Chrome 和 npm 要求明确，关键运行依赖有固定版本，但推荐的 @latest 安装会随时间漂移，Chrome 仅正式支持有限版本范围，且未提供离线或降级方案。测试显示若干明确错误和重连/回退通知，README 也链接故障排除文档；然而提供的材料没有系统展示所有工具的错误分类、修复建议和诊断上下文，所以失败消息未获满分。
文档覆盖编码代理、无 MCP 的 CLI、基础任务 slim 模式、调试、性能、网络、内存、扩展及大量客户端场景，受众和场景说明充分。支持的浏览器、文件根、临时目录、网络护栏局限、提示注入风险以及调用方责任均有明确边界说明。工具使用由显式 MCP 调用和结构化参数触发，精度较好，但服务器不验证代理意图或要求确认，调用安全依赖客户端。Node/Chrome 要求、Windows 特例、多个 IDE/CLI、无头模式、浏览器连接方式、用户数据目录和隔离模式均有具体适配说明，因此环境适配充分。
README 通过工具参考、CLI、变更日志、贡献、故障排除和设计原则组织信息，并提供自动生成的工具与选项索引，信息架构完整。多种客户端的安装步骤、平台差异、先决条件和首个验证提示非常具体。包名和 MCP 名称明确，配置同时保留驼峰及短横线别名；但大量示例使用 @latest，且不同示例有的省略 @latest，削弱了版本稳定性。首个提示和大量配置示例充足，但所给材料中没有完整 FAQ 内容。已知浏览器支持范围、遥测、数据暴露、提示注入、roots 与网络沙箱局限均披露充分。Apache-2.0 元数据与完整 LICENSE 一致。包版本、CHANGELOG 链接、常规提交检查和预发布验证形成清楚的版本更新路径。SECURITY、问题跟踪地址和 Google LLC 作者字段提供维护入口，但发布者身份未被指定注册表验证，材料也未给出具体维护者或支持时限，因此维护责任未满分。
产品向代理提供文本、图像和可选结构化结果，测试覆盖稳定元素标识、页面状态、网络详情、文件路径及快照输出，静态证据充分支持输出可用性。它把 DevTools、Puppeteer、性能洞察、网络、内存、扩展和 PWA 操作集中为 MCP/CLI 工具，相对普通网页自动化具有明确增量价值。成本方面提供 slim、headless、遥测退出和 CrUX 关闭选项，但完整模式工具面较大，会启动或连接 Chrome，并可能产生性能、隐私、令牌和维护成本；材料没有量化基准，故未获满分。
主要能力、风险和配置声明可追溯到具体 README、SECURITY、package 元数据、工作流与测试行为，声明可追踪性充分。版本、许可证、工具行为、路径限制、结构化输出和发布检查在多个来源间相互印证，交叉佐证较强。文档通常明确区分正式支持、可能可用、非完整沙箱及客户端责任；但“可靠自动化”“完整能力”等宣传性表述没有在所给材料中附带基准或全面证据，因此事实与推断分离未获满分。
- 使用统计默认开启，并与 Chrome 自身的遥测设置相互独立；如不希望传送调用成功率、延迟或环境信息，应显式使用 --no-usage-statistics 或相应环境变量。
- MCP 客户端可读取、调试并修改浏览器中的数据；不要在连接的配置文件或页面中保留不愿交给代理客户端的个人信息、会话或凭据。
- MCP roots 和 URL 允许/阻止规则都不是完整的系统沙箱，临时目录仍可访问；高风险使用应叠加操作系统或虚拟机级文件与网络隔离。
- 网页内容会原样返回，可能携带提示注入；客户端需要把页面文本视为不可信输入，并在写文件、安装扩展、下载或产生外部副作用前实施确认。
- 推荐配置使用 chrome-devtools-mcp@latest，无法保证修订固定或更新后行为不变；受控环境宜锁定经审核的精确版本。
- 本结论仅基于所给静态文件，未执行代码、测试、依赖漏洞扫描或网络行为验证，且发布者身份在指定企业注册表中未知。
这个 Agent 能做什么，适合哪些场景？
Chrome DevTools MCP 是一个在本地运行的 Model Context Protocol 服务器，也提供无需 MCP 的 CLI。它让 Codex、Claude Code、Cursor、Copilot 等编码客户端连接并操控实时 Chrome，通过 Chrome DevTools 获取性能轨迹、网络请求、控制台消息、截图和内存快照。浏览器交互由 Puppeteer 驱动，可执行导航、点击、表单填写、脚本求值及文件上传，并自动等待操作结果。服务器既能启动使用专用配置目录的新 Chrome，也能通过自动连接、调试端口或 WebSocket 接入已有实例。它适合需要浏览器级验证和诊断的开发工作，但采用前必须接受其 Chrome 依赖、浏览器数据访问权限以及默认启用的统计收集和 CrUX 查询。
MCP 客户端通过 stdio 启动 npx -y chrome-devtools-mcp@latest，随后调用服务器暴露的工具。服务器可用 new_page、navigate_page、click、fill_form、press_key 和 upload_file 驱动页面，用 evaluate_script 在页面中执行脚本，并以 take_snapshot 或 take_screenshot 返回页面状态。调试流程可通过 list_console_messages、get_console_message、list_network_requests 和 get_network_request 读取控制台与网络细节；性能流程由 performance_start_trace、performance_stop_trace 和 performance_analyze_insight 记录并分析轨迹，还可运行 lighthouse_audit。启用相应类别后，它还能创建和比较堆快照、管理扩展、录制 screencast、调用页面公开的第三方或 WebMCP 工具，以及安装、启动和卸载 PWA。默认情况下服务器按需启动专用 Chrome；也可用 --autoConnect、--browser-url 或 --wsEndpoint 连接现有浏览器。
- 前端工程师在提交改动前，让编码智能体打开目标页面、执行交互并检查控制台错误、源码映射后的堆栈和失败的网络请求。
- 性能工程师需要同时获取实验室轨迹和 CrUX 现场数据时，使用性能工具记录页面加载并提取可执行的优化洞察。
- 测试工程师希望以真实 Chrome 复现用户流程时，用 Puppeteer 驱动导航、点击、拖拽、表单填写、键盘输入和文件上传。
- 排查内存泄漏的开发者启用
--memory-debugging，采集并比较堆快照，检查支配对象、保留路径、重复字符串和对象详情。 - 在容器或受限沙箱中运行编码客户端的团队，通过
--browser-url或--wsEndpoint连接沙箱外已开启远程调试的 Chrome。 - 仅需基础浏览任务且希望减少工具数量的用户，以
--slim --headless暴露导航、脚本执行和截图三类精简能力。
这个 Agent 有哪些优点和局限？
- 将 Chrome DevTools 的性能、网络、控制台、Lighthouse、截图和内存分析集中为可由编码智能体调用的具体工具，而不只提供通用页面点击。
- 同时支持由服务器启动专用 Chrome、自动连接 Chrome 144+、远程调试 URL 和 WebSocket 端点，能覆盖本机与沙箱分离部署。
- Puppeteer 负责浏览器动作并自动等待结果，比单纯发送输入事件更适合可重复的开发验证流程。
- 提供
--slim、工具类别开关、截图压缩与尺寸限制，可按任务减少工具面和对话上下文占用。 - 文档明确列出 Codex、Claude Code、Cursor、Copilot、Gemini CLI、VS Code 等多种 MCP 客户端的配置方式，协议层迁移选择较多。
- 正式支持范围仅包括 Google Chrome 和 Chrome for Testing；其他 Chromium 浏览器可能工作，但不保证兼容。
- MCP 客户端可检查、调试并修改浏览器中的任何数据，连接个人浏览配置或敏感网站会扩大数据暴露风险。
- 使用统计默认开启；性能工具还可能把轨迹 URL 发给 Google CrUX API，需分别使用
--no-usage-statistics和--no-performance-crux关闭。 - 依赖 Node.js LTS、npm 和合适版本的 Chrome；扩展、PWA、WebMCP、内存分析及 screencast 等能力还受实验开关、连接模式、Chrome 版本或 ffmpeg 限制。
- 手动开放远程调试端口会允许本机其他应用控制该浏览器，且 Chrome 要求使用非默认用户数据目录。
- 默认浏览器配置目录会跨运行复用，并且一次只能由一个浏览器使用；并行独立会话需要采用
--isolated。
如何安装或部署这个 Agent？
先安装 Node.js LTS、npm，以及当前稳定版或更高版本的 Google Chrome（也正式支持 Chrome for Testing）。在 MCP 客户端加入：
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
Codex 也可执行：codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest。Claude Code 可执行：claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest。基础浏览可在参数中加入 --slim 和 --headless。来源未要求 API 密钥；若要连接已有 Chrome，则需配置 --autoConnect、--browser-url 或 --wsEndpoint，自定义 WebSocket 鉴权头可通过 --wsHeaders 传入。
如何使用这个 Agent？
保存 MCP 配置并重启或重新加载客户端，然后输入：Check the performance of https://developers.chrome.com。当客户端首次调用需要浏览器的工具时，服务器会启动 Chrome、打开页面并记录性能轨迹；仅连接服务器不会立即启动浏览器。若使用现有 Chrome 144+，先在 chrome://inspect/#remote-debugging 启用远程调试，再以 --autoConnect 启动服务器并在 Chrome 权限对话框中允许连接。沙箱场景可先用非默认用户目录启动 Chrome，例如 Linux 上执行 /usr/bin/google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable，再给服务器传入 --browser-url=http://127.0.0.1:9222。如需并发智能体共享服务器，加入 --experimentalPageIdRouting；多个独立会话应再加入 --isolated，避免争用同一个浏览器配置目录。
这个 Agent 与同类方案有什么区别？
完整模式面向深入调试，提供自动化、性能、网络、控制台及其他可选工具；--slim 模式只暴露导航、脚本执行和截图三项工具，更适合基础浏览和控制上下文规模。MCP 服务器适合让兼容客户端以结构化工具调用集成浏览器；附带的 CLI 则用于不采用 MCP 的场景。默认启动专用 Chrome 能隔离日常浏览状态，而连接已有 Chrome 更适合保留登录和手工测试状态，但会提高敏感数据暴露风险。
常见问题
需要 API 密钥或付费服务吗？
它能读取我的登录状态和页面数据吗？
--isolated 创建关闭后自动清理的临时用户目录。如何关闭遥测和外部性能数据查询？
--no-usage-statistics 可退出使用统计，加入 --no-performance-crux 可阻止向 CrUX API 发送性能轨迹 URL。设置 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI 也会关闭统计收集。为什么连接 MCP 后没有出现浏览器？
--autoConnect 或远程调试连接，Chrome 必须先运行并完成相应的远程调试配置。多个智能体可以共用一个服务器吗？
--experimentalPageIdRouting，让页面范围工具通过 pageId 路由到各自标签页。若是多个独立 MCP 会话各自启动 Chrome，还应使用 --isolated 避免默认配置目录冲突。