面向编程智能体的Chrome开发者工具
Chrome DevTools MCP 是一个基于 Model-Context-Protocol (MCP) 的服务器工具,它允许 AI 编程助手(如 Claude、Cursor 或 Copilot)直接连接并控制一个正在运行的 Chrome 浏览器。通过将 Chrome 开发者工具的强大功能转化为 AI 可调用的工具,该项目使 AI 能够执行可靠的浏览器自动化、进行深度调试和性能分析。具体而言,AI 可以录制性能追踪、分析网络请求、截取屏幕截图以及检查控制台日志,甚至结合 Puppeteer 实现复杂的自动化操作。这为开发者提供了一个智能的辅助伙伴,能够协助排查网页问题、优化性能或自动执行重复的浏览器测试任务,显著提升开发效率。需要注意的是,该工具会向 AI 客户端暴露浏览器实例的全部内容,因此应避免在处理敏感信息时使用。
💡 应用场景
这个项目最适合需要将Chrome DevTools的强大调试和性能分析能力集成到AI编程工作流中的场景。
自动化网页性能分析
问题:开发者需要手动在Chrome DevTools中录制性能追踪、分析网络请求和运行时性能,过程繁琐且难以自动化。
方案:通过AI助手调用MCP服务器,自动录制性能追踪、分析网络瀑布图并生成性能报告,实现一键式性能分析。
示例:让AI助手自动打开目标网页,录制Lighthouse性能追踪,分析关键性能指标(FCP、LCP等),并生成优化建议报告。
智能网页调试助手
问题:调试复杂的前端问题时,开发者需要反复在浏览器控制台、网络面板和源代码之间切换,效率低下。
方案:AI助手可以直接通过MCP服务器检查控制台错误(带源码映射)、分析网络请求状态和内容,快速定位问题根源。
示例:网页加载异常时,让AI助手自动检查控制台错误堆栈、分析失败的XHR/Fetch请求,并截图当前页面状态供分析。
可靠浏览器自动化
问题:传统的浏览器自动化脚本(如Puppeteer)编写和维护复杂,需要处理各种等待条件和异常情况。
方案:AI助手通过MCP服务器控制浏览器,利用Puppeteer的自动等待机制,智能执行点击、输入、导航等操作并验证结果。
示例:让AI助手自动完成一个多步骤的表单填写和提交流程,在每个步骤后检查页面状态,确保操作成功执行。
结合真实用户数据
问题:实验室性能数据与真实用户体验脱节,开发者难以获得全面的性能洞察。
方案:项目可自动将性能追踪数据发送到Google CrUX API,获取真实用户的性能数据,提供实验室与现场数据的对比分析。
示例:分析某电商网站商品详情页时,不仅获得实验室性能指标,还能看到真实用户在该页面的LCP、FID等核心Web指标数据。
📊 项目信息
- 语言
- TypeScript
- Stars
- ⭐ 40,962
- Forks
- 2,601
- 今日新增
- +501
- 排名
- #5
- 收录
- 总榜
- 趋势日期
- 2026年5月22日
- 最后推送
- 2026/5/22
🏷️ 标签
5分钟上手 Chrome DevTools MCP
让AI助手(如Claude、Cursor)连接并控制Chrome浏览器,实现浏览器自动化和调试
🖥️ 操作系统
⚙️ 运行环境
🔧 工具
📝 操作步骤
安装Chrome DevTools MCP
通过npm全局安装MCP服务器
全局安装MCP服务器
$ npm install -g chrome-devtools-mcp配置MCP客户端(以VS Code/Copilot为例)
在VS Code中配置MCP服务器
安装MCP服务器管理扩展(如果尚未安装)
$ code --install-extension ms-vscode.mcp-server-management添加MCP服务器配置
在VS Code中创建MCP服务器配置
测试连接
向AI助手发送测试指令,验证MCP服务器是否正常工作
✅ 验证成功
确认MCP服务器已正确配置并可以控制Chrome浏览器
- ✓AI助手能够理解并执行浏览器相关指令
- ✓Chrome浏览器自动启动并响应操作
- ✓可以成功执行如截图、性能分析等操作
⚡ 快速提示
🔍 常见问题排查
❓ Chrome浏览器没有自动启动
→ 1. 确保Chrome已安装且版本符合要求 2. 手动启动Chrome并确保没有其他Chrome实例在运行 3. 尝试重启MCP服务器
❓ AI助手无法识别浏览器工具
→ 1. 检查MCP服务器配置是否正确 2. 确认MCP服务器正在运行 3. 重启AI客户端和MCP服务器
❓ 权限错误或安装失败
→ 1. 使用管理员权限运行安装命令 2. 检查Node.js版本是否符合要求 3. 清理npm缓存:npm cache clean --force
🎯 下一步
探索更多工具
尝试使用其他工具如性能分析、网络请求监控、自动化表单填写等
连接到已运行的Chrome实例
学习如何连接到已运行的Chrome浏览器进行调试
查看工具参考文档
了解所有可用工具的功能和使用方法
难度
初级
预计时间
2-3小时
目标人群
对AI编程助手(如Claude、Cursor、Copilot)感兴趣的前端开发者或自动化测试初学者,希望了解如何让AI控制浏览器进行调试和自动化操作
🎯 学完你将掌握
学会配置Chrome DevTools MCP服务器,让AI助手能够控制Chrome浏览器进行性能分析、调试和自动化操作
📋 前置知识
项目基于Node.js运行,需要能使用npm安装包和运行命令
项目需要连接Chrome浏览器,需要了解基本的浏览器操作
需要有一个支持MCP协议的AI编程助手客户端
项目使用TypeScript开发,但作为使用者只需了解基础概念
📚 学习资源
GitHub README
项目的主要文档,包含安装、配置、工具列表和故障排除
MCP协议文档
了解Model-Context-Protocol的标准和规范
Puppeteer文档
Chrome DevTools MCP底层使用Puppeteer进行浏览器自动化
GitHub Issues
查看常见问题和解决方案,或报告自己遇到的问题
🗺️ 学习阶段
环境准备与基础理解
检查系统要求
确认你的电脑已安装Node.js v20.19或更高版本、Chrome稳定版和npm
了解MCP概念
理解Model-Context-Protocol(MCP)是什么:它是一个让AI助手能够调用外部工具的标准协议
选择MCP客户端
根据README选择你正在使用的AI助手(如Claude Code、Cursor、Copilot等),并找到对应的配置部分
安装与配置
安装Chrome DevTools MCP
根据你选择的MCP客户端,按照README中的对应配置进行安装
配置MCP服务器
在你的MCP客户端中添加Chrome DevTools MCP服务器配置
启动Chrome调试模式
确保Chrome浏览器已启动并开启远程调试功能(如果需要手动连接)
快速验证与初体验
运行测试提示
在你的AI助手中输入README提供的测试提示:“Record a performance trace of google.com”
观察浏览器行为
观察Chrome浏览器是否自动打开并访问google.com,然后记录性能数据
查看AI助手响应
查看AI助手是否返回了性能追踪结果或相关分析
核心功能探索
尝试自动化操作
让AI助手执行简单的浏览器操作,如点击、输入文本、导航等
体验调试功能
尝试使用截图、获取控制台消息、分析网络请求等功能
测试性能分析
让AI助手记录和分析网站性能,了解性能洞察功能
安全与隐私注意事项
理解安全警告
仔细阅读README中的免责声明,理解该工具会向AI暴露浏览器全部内容
配置隐私选项
根据需要禁用使用统计收集(--no-usage-statistics)或CrUX数据发送(--no-performance-crux)
⚠️ 常见错误
❌ Node.js版本过低
✅ 确保使用Node.js v20.19或更高版本,使用nvm或直接下载最新LTS版本
❌ Chrome未安装或版本过旧
✅ 安装最新稳定版Chrome浏览器,并确保已关闭所有Chrome实例后再测试
❌ MCP客户端配置错误
✅ 仔细核对README中对应客户端的配置示例,注意命令格式和参数
❌ 端口冲突或浏览器未启动调试模式
✅ 如果使用--browserUrl手动连接,确保Chrome已启动远程调试(通常使用--remote-debugging-port=9222)
❌ 在敏感环境中使用
✅ 永远不要在使用银行、医疗或个人账户的浏览器实例上使用此工具
🚀 后续方向
掌握基础使用后,可以探索更复杂的自动化场景,如结合Puppeteer脚本、集成到CI/CD流程、开发自定义MCP工具,或深入了解Chrome DevTools Protocol以扩展功能