ChromeDevTools GitHub avatar

chrome-devtools-mcp

TypeScript
浏览器调试MCP服务ChromeDevTools最近推送 2026年11月18日
MCP 与工具接入Apache-2.058.0k4,869137 issues7 天 +2,951

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年10月24日

让编程代理通过 MCP 或命令行控制 Chrome,并进行调试、自动化和性能分析。

chrome-devtools-mcp 将 Chrome DevTools 能力提供给编程代理,也提供可在终端使用的 CLI。它基于 Puppeteer 控制 Chrome,可检查网络请求、控制台信息、截图并记录性能追踪。

推荐指数

5.0

适合需要让 AI 代理检查和操作真实 Chrome 的开发者,使用前应留意浏览器数据与遥测设置。

近 7 天

+2,951

新增 Star

总 Star 排名

#90

雷达追踪的 3,931 个 AI 仓库中

创建于

2025

2025年9月11日

核心亮点

  • 1MCP 与 CLI

    既能接入支持 MCP 的编程代理,也能从终端直接控制浏览器。

  • 2页面调试

    可检查网络请求、浏览器控制台信息并获取截图。

  • 3性能分析

    可记录性能追踪,并提取可执行的性能洞察。

  • 4附带技能

    提供无障碍、Cookie、LCP 和内存泄漏等调试技能。

适用场景

  • 让编程代理检查网页性能

    例如:请代理分析一个页面的性能并记录追踪。

  • 排查页面网络或控制台问题

    例如:使用 Chrome DevTools MCP 检查网页请求和控制台报错。

  • 自动化浏览器操作

    例如:从 CLI 打开指定网页并保存截图。

  • 诊断常见浏览器问题

    例如:使用随附技能排查 Cookie、无障碍或内存泄漏问题。

它是怎么工作的

  1. 第 1 步

    配置入口

    在 MCP 客户端中添加服务器配置,或安装并使用 CLI。

  2. 第 2 步

    启动浏览器

    MCP 客户端首次调用需要浏览器的工具时,服务器会自动启动浏览器。

  3. 第 3 步

    执行操作

    代理或 CLI 通过 Puppeteer 控制 Chrome,并等待操作结果。

  4. 第 4 步

    检查结果

    获取页面调试信息、截图或性能追踪结果。

快速上手

  1. 1

    准备环境

    安装 Node.js LTS、npm 和当前稳定版或更新版本的 Chrome。

  2. 2

    配置 MCP

    将以下配置加入 MCP 客户端配置文件。

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

    测试调用

    在 MCP 客户端中请求检查一个页面的性能。

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

    使用 CLI

    也可以安装 CLI 并导航到页面、保存截图。

    npm i chrome-devtools-mcp@latest -g
    chrome-devtools navigate_page 1 --url "https://developers.chrome.com"
    chrome-devtools take_screenshot 1 --filePath screenshot.png

适合谁

  • 希望编程代理操作 Chrome 的开发者
  • 需要自动化浏览器测试或页面检查的工程师
  • 需要排查网页性能、网络请求或控制台问题的开发者
  • 希望从命令行控制 Chrome 的用户

不太适合

  • 需要官方支持非 Chrome 浏览器的用户
  • 不希望工具访问浏览器内容或收集使用统计的用户

成熟度

  • 活跃度仓库提供最近推送日期为 2026-10-23;未提供提交频率或近期版本记录供进一步判断。
  • 文档README 包含安装、MCP 配置、CLI、技能和隐私说明。
  • 社区有 54,013 个 star、6,636 个 fork 和 106 个开放 issue。
  • 上手难度可通过 npx 快速配置,但需准备 Node.js、npm、Chrome 和 MCP 客户端。

使用前注意

  • · 项目官方支持 Google Chrome 和 Chrome for Testing;其他 Chromium 浏览器不保证可用。
  • · MCP 客户端可查看、调试和修改浏览器及 DevTools 中的数据,不要共享敏感信息。
  • · 使用统计默认开启,可通过 --no-usage-statistics 关闭;性能工具也可能向 Google CrUX API 发送追踪网址,可用 --no-performance-crux 关闭。
  • · 仓库许可为 Apache-2.0。

主题标签

mcp-serverpuppeteerchrome-devtoolsbrowserchromedebuggingdevtoolsmcp