Chrome DevTools for coding agents
💡 Use Cases
这个项目最适合需要将Chrome DevTools的强大调试和性能分析能力集成到AI编程工作流中的场景。
自动化网页性能分析
Problem: 开发者需要手动在Chrome DevTools中录制性能追踪、分析网络请求和运行时性能,过程繁琐且难以自动化。
Solution: 通过AI助手调用MCP服务器,自动录制性能追踪、分析网络瀑布图并生成性能报告,实现一键式性能分析。
Example: 让AI助手自动打开目标网页,录制Lighthouse性能追踪,分析关键性能指标(FCP、LCP等),并生成优化建议报告。
智能网页调试助手
Problem: 调试复杂的前端问题时,开发者需要反复在浏览器控制台、网络面板和源代码之间切换,效率低下。
Solution: AI助手可以直接通过MCP服务器检查控制台错误(带源码映射)、分析网络请求状态和内容,快速定位问题根源。
Example: 网页加载异常时,让AI助手自动检查控制台错误堆栈、分析失败的XHR/Fetch请求,并截图当前页面状态供分析。
可靠浏览器自动化
Problem: 传统的浏览器自动化脚本(如Puppeteer)编写和维护复杂,需要处理各种等待条件和异常情况。
Solution: AI助手通过MCP服务器控制浏览器,利用Puppeteer的自动等待机制,智能执行点击、输入、导航等操作并验证结果。
Example: 让AI助手自动完成一个多步骤的表单填写和提交流程,在每个步骤后检查页面状态,确保操作成功执行。
结合真实用户数据
Problem: 实验室性能数据与真实用户体验脱节,开发者难以获得全面的性能洞察。
Solution: 项目可自动将性能追踪数据发送到Google CrUX API,获取真实用户的性能数据,提供实验室与现场数据的对比分析。
Example: 分析某电商网站商品详情页时,不仅获得实验室性能指标,还能看到真实用户在该页面的LCP、FID等核心Web指标数据。
📊 Project Info
- Language
- TypeScript
- Stars
- ⭐ 40,472
- Forks
- 2,571
- Today
- +151
- Ranking
- #8
- Collection
- Overall
- Trending Date
- May 21, 2026
- Last Push
- 5/21/2026
🏷️ Topics
5分钟上手 Chrome DevTools MCP
让AI助手(如Claude、Cursor)连接并控制Chrome浏览器,实现浏览器自动化和调试
🖥️ OS
⚙️ Runtime
🔧 Tools
📝 Steps
安装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浏览器自动启动并响应操作
- ✓可以成功执行如截图、性能分析等操作
⚡ Quick Tips
🔍 Troubleshooting
❓ 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
🎯 Next Steps
探索更多工具
尝试使用其他工具如性能分析、网络请求监控、自动化表单填写等
连接到已运行的Chrome实例
学习如何连接到已运行的Chrome浏览器进行调试
查看工具参考文档
了解所有可用工具的功能和使用方法
Difficulty
初级
Est. Time
2-3小时
Target Audience
对AI编程助手(如Claude、Cursor、Copilot)感兴趣的前端开发者或自动化测试初学者,希望了解如何让AI控制浏览器进行调试和自动化操作
🎯 What You'll Learn
学会配置Chrome DevTools MCP服务器,让AI助手能够控制Chrome浏览器进行性能分析、调试和自动化操作
📋 Prerequisites
项目基于Node.js运行,需要能使用npm安装包和运行命令
项目需要连接Chrome浏览器,需要了解基本的浏览器操作
需要有一个支持MCP协议的AI编程助手客户端
项目使用TypeScript开发,但作为使用者只需了解基础概念
📚 Resources
GitHub README
项目的主要文档,包含安装、配置、工具列表和故障排除
MCP协议文档
了解Model-Context-Protocol的标准和规范
Puppeteer文档
Chrome DevTools MCP底层使用Puppeteer进行浏览器自动化
GitHub Issues
查看常见问题和解决方案,或报告自己遇到的问题
🗺️ Learning Phases
环境准备与基础理解
检查系统要求
确认你的电脑已安装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)
⚠️ Common Mistakes
❌ Node.js版本过低
✅ 确保使用Node.js v20.19或更高版本,使用nvm或直接下载最新LTS版本
❌ Chrome未安装或版本过旧
✅ 安装最新稳定版Chrome浏览器,并确保已关闭所有Chrome实例后再测试
❌ MCP客户端配置错误
✅ 仔细核对README中对应客户端的配置示例,注意命令格式和参数
❌ 端口冲突或浏览器未启动调试模式
✅ 如果使用--browserUrl手动连接,确保Chrome已启动远程调试(通常使用--remote-debugging-port=9222)
❌ 在敏感环境中使用
✅ 永远不要在使用银行、医疗或个人账户的浏览器实例上使用此工具
🚀 Next Steps
掌握基础使用后,可以探索更复杂的自动化场景,如结合Puppeteer脚本、集成到CI/CD流程、开发自定义MCP工具,或深入了解Chrome DevTools Protocol以扩展功能