Brand LogoBrand Logo (Dark)
首页智能体广场工具包广场GitHub 精选提交智能体博客

分类

  • AI 绘画
  • AI 音频
  • 自动化工具
  • 聊天机器人
  • 编程工具
  • 金融工具

分类

  • 大语言模型
  • 营销工具
  • 零代码/低代码
  • 研究与搜索
  • 视频与动画
  • 视频编辑

GitHub 精选

  • DeerFlow — 字节跳动开源超级智能体框架

最新博客

  • OpenClaw vs Composer 2 Which AI Assistant Delivers More Value
  • Google AI Studio vs Anthropic Console
  • Stitch 2.0 vs Lovable Which AI Design Tool Wins in 2026
  • Monetizing AI for Solopreneurs and Small Teams in 2026
  • OpenClaw vs MiniMax Which AI Assistant Wins in 2026

最新博客

  • OpenClaw vs KiloClaw Is Self-Hosting Still Better
  • OpenClaw vs Kimi Claw
  • GPT-5.4 vs Gemini 3.1 Pro
  • Farewell to Bloomberg Terminal as Perplexity Computer AI Redefines Finance
  • Best Practices for OpenClaw
LinkStartAI© 2026 LinkstartAI. 版权所有。
联系我们关于
  1. 首页
  2. GitHub 精选
  3. chrome-devtools-mcp
chrome-devtools-mcp logo

chrome-devtools-mcp

把 Chrome DevTools 能力封装成 MCP 工具:让编码智能体可控地读 DOM、网络与控制台,并自动化复现与调试。
26.1kTypeScriptApache-2.0
typescriptnodejsmcp-serverchrome-devtools-protocolbrowser-debuggingagent-tools
frontend-debugging
e2e-troubleshooting
alternative-to-playwright
alternative-to-selenium
alternative-to-puppeteer
alternative-to-manual-devtools

项目简介

chrome-devtools-mcp 的定位很直接:把浏览器调试从“人盯着 DevTools 点来点去”变成“智能体按工具接口可重复执行”。它用 Model Context Protocol (MCP) 把页面检查、网络抓取、控制台观察、性能采样等动作封装为可调用的工具,并通过 Chrome DevTools Protocol 在底层驱动浏览器调试会话。对前端与全栈团队来说,这相当于把排障经验固化成可脚本化流程:同一个 bug 的复现步骤、关键证据与修复验证可以被自动跑一遍,减少口口相传与截图沟通。

痛点 vs 创新

✕传统痛点✓创新方案
手动 DevTools 调试很难标准化:同一个问题不同人收集的证据不同,复现步骤也容易遗漏。chrome-devtools-mcp 把调试动作做成 MCP 工具,让智能体以结构化调用执行并返回可比对的证据。
测试工具更擅长“跑用例”,但对排障所需的 DOM/Network/Console/Performance 证据采集缺少统一接口。用 CDP 作为底层执行面,把浏览器会话的观察与采样纳入可编排的调试流水线。

架构深度解析

MCP 工具面:把调试能力变成可调用接口
将页面检查、网络请求观察、控制台读取、性能采样等能力暴露为 MCP tools,输入输出结构化,便于自动化与审计。
CDP 执行面:连接浏览器并驱动会话
通过 Chrome DevTools Protocol 连接到浏览器调试端口,管理目标(target)、会话(session)与事件流(event stream),把观察与采样变成可复现操作。
证据链输出:面向排障的最小充分信息
把关键证据(选择器、请求/响应摘要、控制台错误、性能片段、截图/trace 等)以可持久化格式导出,支持在 CI 与本地复跑对比。

部署指南

1. 准备运行时(安装 Node.js)

bash
1node --version

2. 克隆仓库并安装依赖

bash
1git clone https://github.com/ChromeDevTools/chrome-devtools-mcp.git && cd chrome-devtools-mcp && npm install

3. 启动 MCP Server

bash
1npm run start

4. 以远程调试模式启动 Chrome

bash
1google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-devtools-mcp

5. 在你的 MCP 客户端中添加该 server 并验证工具可用

bash
1# 在客户端配置中添加 server,然后调用一次 tools/list 或等价入口验证

落地场景

核心场景目标人群解决方案最终收益
把线上疑难 bug 变成可复现的证据包前端/全栈开发自动抓 DOM 状态、关键请求、控制台错误与性能片段把口述问题变成可重复运行的调试脚本与证据链
CI 中的失败用例自动采证维护 E2E/回归的团队失败时自动导出 network/console/trace 片段减少“只能在我电脑复现”的排障时间
客服/支持场景的页面取证与定位技术支持与工程协作用工具化方式收集页面状态与错误线索更快定位问题归因并把信息传回研发

避坑指南

避坑指南
  • 需要以远程调试端口连接浏览器,会引入安全面:建议只在本机或受控网络中使用,并限制可访问目标。
  • 不同 Chromium 版本的 CDP 行为可能存在差异,建议在目标环境固定浏览器版本并做兼容性验证。

常见问题

这和 E2E 测试框架(如 Playwright)有什么区别?▾
E2E 更偏脚本执行与断言,而这里更偏调试取证:把 DOM/Network/Console/Performance 的观察能力工具化,让智能体能收集证据、解释现象并指导修复。
如何避免远程调试端口带来的安全风险?▾
把调试端口绑定在 localhost,使用隔离的用户数据目录,并把可访问目标限制在受控站点;不要在公网暴露端口。
它能在 CI 或无界面环境跑吗?▾
可以,但前提是你能启动可被 CDP 连接的 Chromium 实例并稳定复现环境差异;建议固定浏览器版本,并把关键证据(trace、console、network 摘要)作为构建产物保存。
在 GitHub 上查看

项目指标

Star 数26.1 k
编程语言TypeScript
开源协议Apache-2.0
部署难度中等

Table of Contents

  1. 01项目简介
  2. 02痛点 vs 创新
  3. 03架构深度解析
  4. 04部署指南
  5. 05落地场景
  6. 06避坑指南
  7. 07常见问题

相关项目

Pi Monorepo
Pi Monorepo
14.1 k·TypeScript
QMD
QMD
9.6 k·TypeScript
NanoClaw
NanoClaw
8.6 k·TypeScript
DeerFlow — 字节跳动开源超级智能体框架
DeerFlow — 字节跳动开源超级智能体框架
26.1 k·Python