chrome-devtools-mcp 是什么?

chrome-devtools-mcp 是 Google Chrome DevTools 团队官方推出的 MCP 服务器,让编码代理(如 Claude、Cursor、Copilot、Antigravity 等)能控制并检查一个真实运行的 Chrome 浏览器。它把 Chrome DevTools 的完整能力——可靠的浏览器自动化、深入调试、性能分析——通过 Model Context Protocol 暴露给 AI 助手,底层用 Puppeteer 驱动并自动等待动作结果。它以 npm 包 chrome-devtools-mcp 分发,也提供不依赖 MCP 的 CLI。一句话:给 AI 代理装上一双能开浏览器、看网络、抓性能、读控制台的「眼睛和手」。Apache-2.0 开源、TypeScript 实现。

⭐ 41,925 Stars 🍴 2,670 Forks TypeScript Apache-2.0 作者: ChromeDevTools
来源:README 顶部简介与 Key features、Getting started、GitHub meta(ChromeDevTools/chrome-devtools-mcp,TypeScript,Apache-2.0,npm 包) 查看 GitHub 仓库 →

为什么值得关注

让 AI 代理「能动手操作浏览器」是当前 agentic 编码与前端调试的刚需,但社区里多是第三方实现,质量与稳定性参差。chrome-devtools-mcp 由 Chrome DevTools 官方团队维护,直接基于官方 DevTools 前端与 Puppeteer,权威、可靠、跟进最新稳定版 Chrome,并覆盖性能 trace、网络分析、控制台(带 source map 堆栈)、截图、输入/导航自动化等成体系的工具集,几乎是「官方答案」。npx 一键接入各 MCP 客户端、还有 slim/headless 模式,门槛低。这些因素使它累计约 4.1 万星,成为该类工具的标杆。

来源:README Disclaimers(官方支持范围)、Key features、Getting started、GitHub meta(stars 41148、created_at 2025-09-11)

核心功能

性能洞察(trace + CrUX)

用 Chrome DevTools 录制性能 trace 并提取可执行的性能洞察(3 个性能工具);性能工具可向 Google CrUX API 发送 trace URL 以拉取真实用户体验数据,把实验室数据与现场数据并列,可用 --no-performance-crux 关闭。

来源:README Key features「Get performance insights」、Disclaimers(CrUX)、README 工具分类「Performance (3 tools)」
深入浏览器调试

分析网络请求、截图、查看浏览器控制台消息(带 source map 后的堆栈),并支持内存/堆快照分析。对应工具分类含 Debugging(8)、Network(2)、Memory(5)等。

来源:README Key features「Advanced browser debugging」、工具分类(Debugging 8、Network 2、Memory 5)、src/tools(console/network/memory/lighthouse)
可靠的浏览器自动化

用 Puppeteer 自动化 Chrome 操作并自动等待动作结果,提供输入自动化(10 个工具,如 click/click_at)与导航自动化(6 个工具,如 navigate_page),让代理稳定地点击、输入、跳转。

来源:README Key features「Reliable automation」、工具分类(Input 10、Navigation 6)、src/tools/input.ts、pages.ts
模拟、扩展与脚本能力

提供设备/网络模拟(Emulation,2 工具)、扩展相关工具(Extensions,5 工具)、页面脚本执行(script)、截图/录屏(screenshot/screencast)、第三方开发者工具列举与 WebMCP 等,覆盖前端调试与自动化的多数场景。

来源:README 工具分类(Emulation 2、Extensions 5、Third-party 2、WebMCP 2)、src/tools(emulation/extensions/script/screencast/webmcp)
灵活接入与精简模式

通过 npx 一键加入各 MCP 客户端配置(Claude/Cursor/Copilot/Antigravity/Amp/Kiro 等都有说明),可连本机已开的 Chrome(--browser-url)或自动启动;提供 --slim 精简工具集与 --headless 无头模式,并附独立 CLI 供非 MCP 使用。

来源:README Getting started、MCP Client configuration、Slim 模式、docs/cli.md

技术架构

项目是一个 TypeScript 实现的 MCP 服务器,核心在 src/ 下:index.ts 入口、McpContext/McpPage/McpResponse 管理 MCP 会话与页面、ToolHandler 分发工具、browser.ts 与 DevToolsConnectionAdapter 负责连接/驱动 Chrome(基于 Puppeteer 与 DevTools 协议),WaitForHelper 实现动作后的自动等待,HeapSnapshotManager/PageCollector 等支撑调试与采集。工具按域拆在 src/tools/ 下:input、pages(导航)、emulation、performance、network、console、memory、lighthouse、extensions、script、screenshot、screencast、snapshot、webmcp、thirdPartyDeveloper,并有 categories.ts 归类与 slim/ 精简子集。还提供 daemon、formatters、bin(CLI)等。它默认连接官方 Google Chrome / Chrome for Testing,支持连已开实例或自动启动;并内置(默认开启、可关闭)的使用统计与更新检查、以及性能工具向 CrUX 取数的可选行为。仓库还带 .claude-plugin/.cursor-plugin/.gemini 等多客户端适配。

来源:仓库目录树(src/* 与 src/tools/*、daemon、bin)、README 工具分类与 Disclaimers/Usage statistics 段

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Puppeteer(驱动 Chrome 自动化)Puppeteer(驱动… Chrome DevTools 协议 / devtools-frontendChrome DevTool… Lighthouse(性能)Lighthouse(性… Google CrUX API(可选,性能现场数据)Google CrUX AP… Node.js(LTS) 性能洞察(trace + CrUX)性能洞察(trace + Cr… 深入浏览器调试 可靠的浏览器自动化 模拟、扩展与脚本能力 灵活接入与精简模式 chrome-devtools-mcp 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript框架MCP(Model Context Protocol)服务器
Puppeteer(驱动 Chrome 自动化)Chrome DevTools 协议 / devtools-frontendLighthouse(性能)Google CrUX API(可选,性能现场数据)Node.js(LTS)
npm 包 chrome-devtools-mcp,经 npx 接入各 MCP 客户端;需 Node LTS 与当前稳定版 Chrome;支持 --slim/--headless 与独立 CLI;可连已开 Chrome 或自动启动
来源:README Key features/Requirements/Getting started、package.json 与 src 依赖(puppeteer/lighthouse)

快速上手

确保已装 Node.js LTS、npm 与当前稳定版 Chrome。在 MCP 客户端配置里加一个服务器:command 为 npx、args 为 `["-y", "chrome-devtools-mcp@latest"]`(用 @latest 保证总是最新版)。只做基础浏览器任务可加 `--slim --headless`。要连本机已开的 Chrome(如 Antigravity 内置浏览器),加 `--browser-url=http://127.0.0.1:9222`。各客户端(Amp、Antigravity、Cursor、Copilot、Kiro 等)README 都给了对应配置或安装命令。配好后可直接让代理执行「检查 https://developers.chrome.com 的性能」之类指令,它会打开浏览器并录制性能 trace。隐私上可用 --no-usage-statistics 关闭使用统计、--no-performance-crux 关闭 CrUX 取数。
来源:README Getting started、MCP Client configuration、Usage statistics/Disclaimers 段

使用场景

面向用 AI 代理做前端开发、调试与测试的人:让 Claude/Cursor/Copilot 等直接打开真实 Chrome 复现并调试问题、分析网络请求与控制台错误(带 source map 堆栈)、对页面做性能 trace 与洞察、按指令点击/输入/导航做端到端自动化、模拟设备与网络条件、跑 Lighthouse 与内存分析。也适合搭建「代理驱动的浏览器自动化/质量检查」流水线,或作为研究 MCP + 浏览器控制的官方参考实现。

来源:README Key features、工具分类、Getting started 示例

优势与局限

优势

  • 官方出品、权威可靠:由 Chrome DevTools 团队维护,基于官方 DevTools 前端与 Puppeteer,承诺跟进最新 Extended Stable Chrome。
  • 能力全面成体系:性能、网络、控制台、内存、输入/导航自动化、模拟、扩展、脚本等数十个工具,覆盖调试与自动化主流场景。
  • 接入简单、可裁剪:npx 一键加入各主流 MCP 客户端,提供 slim/headless 模式与独立 CLI,可连已开实例或自动启动。
  • Apache-2.0、约 4.1 万星,文档(工具参考、设计原则、排错)齐全,社区与生态成熟。

局限

  • 安全/隐私需注意:它会把浏览器内容暴露给 MCP 客户端,可读改浏览器与 DevTools 中的任意数据,不应在其中放敏感信息。
  • 默认开启使用统计与更新检查、性能工具默认向 Google CrUX 取数,介意者需用 --no-usage-statistics / --no-performance-crux 或相应环境变量关闭。
  • 官方仅保证支持 Google Chrome 与 Chrome for Testing,其它 Chromium 浏览器可能出现异常。
  • 需要本机有 Node 与 Chrome 环境,自动化会真实驱动浏览器,对资源与执行环境有要求。
来源:README Disclaimers/Usage statistics/Update checks/Requirements 段

最新版本

项目以 npm 包 chrome-devtools-mcp 持续滚动发版(推荐用 @latest 始终拿最新),并内置更新检查。工具集已覆盖输入(10)、导航(6)、调试(8)、内存(5)、扩展(5)、性能(3)、网络(2)、模拟(2)、第三方(2)、WebMCP(2) 等多个分类。仓库迭代活跃,最近一次更新在 2026-05-22。详细变更见 CHANGELOG。

来源:README 版本徽章/工具分类/Update checks、GitHub meta pushed_at 2026-05-22

总结评价

chrome-devtools-mcp 基本是「让 AI 代理操控 Chrome」这件事的官方标准答案:Chrome DevTools 团队亲自维护、基于官方 DevTools 与 Puppeteer,性能、网络、控制台、内存、自动化等工具一应俱全,接入简单、可裁剪、文档完备、近 4.1 万星。对用 Claude/Cursor/Copilot 做前端开发、调试与端到端自动化的人来说,它几乎是首选。使用时记住几点:它会把浏览器内容开放给 MCP 客户端、勿放敏感信息;使用统计与 CrUX 取数默认开启、介意可关;官方只保证 Chrome/Chrome for Testing。作为权威、全面的浏览器控制 MCP 服务器,它的可靠性与生态都是同类里最强的之一。

来源:综合 README、工具分类、Disclaimers 与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 18:26. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件