项目简介 Chrome DevTools MCP服务器是为AI编码助手(如Gemini, Claude, Cursor, Copilot)设计的后端服务,它允许这些助手通过Model Context Protocol (MCP) 标准协议,与实时运行的Chrome浏览器进行交互。利用Chrome DevTools和Puppeteer的强大功能,AI助手可以实现浏览器自动化、深度调试、性能分析等多种操作,从而提升开发和测试效率。

主要功能点

  • 浏览器自动化: 模拟用户操作,如点击、输入、拖拽、表单填充和文件上传,实现可靠的网页交互。
  • 性能洞察: 记录并分析网页性能追踪,提取关键性能指标,帮助识别和解决性能瓶颈。
  • 高级调试: 检查网络请求、捕获屏幕截图、查看浏览器控制台消息,辅助问题诊断。
  • 页面管理与仿真: 支持创建、关闭、切换页面,以及调整页面大小、模拟CPU和网络条件,方便在不同环境下进行测试。
  • 脚本执行: 允许AI助手在浏览器页面中执行自定义JavaScript代码,获取页面动态信息。

安装步骤

  1. 安装Node.js: 确保您的系统已安装Node.js 22.12.0或更高版本。您可以访问Node.js官网下载并安装。
  2. 安装Chrome浏览器: 确保您的系统已安装最新稳定版Chrome浏览器。您可以访问Google Chrome官网下载并安装。
  3. 安装npm: npm通常随Node.js一起安装,请确保其可用。
  4. 无直接安装步骤: 'chrome-devtools-mcp' 通常通过 'npx' 命令按需运行,无需预先全局安装。

服务器配置 MCP服务器是供MCP客户端使用的。要让您的MCP客户端连接到Chrome DevTools MCP服务器,您需要在MCP客户端的配置中添加以下JSON片段。具体配置方式请参考您所使用的MCP客户端文档。

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

参数说明:

  • 'chrome-devtools': 这是您为该MCP服务器定义的名称,客户端将使用此名称引用该服务器。
  • 'command': 启动MCP服务器的命令。这里使用'npx'来运行最新版本的'chrome-devtools-mcp'包,确保始终使用最新功能。
  • 'args': 传递给MCP服务器启动命令的额外参数,用于配置浏览器行为和服务器设置。
    • '--channel': 指定使用特定的Chrome浏览器发布渠道。可选值包括'stable' (默认), 'canary', 'beta', 'dev'。
    • '--headless': 一个布尔值,'true'表示以无头模式(无图形用户界面)运行Chrome,'false'(默认)表示有界面模式。
    • '--isolated': 一个布尔值,'true'表示为浏览器创建一个临时用户数据目录,关闭后会自动清理。'false'(默认)表示使用共享的用户数据目录。
    • '--browserUrl': 一个字符串,用于连接到一个已经运行的Chrome实例的调试URL(例如:'http://127.0.0.1:9222')。
    • '--executablePath': 一个字符串,指定自定义Chrome浏览器可执行文件的完整路径。
    • '--logFile': 一个字符串,指定将服务器运行日志保存到的文件路径。

基本使用方法 配置完成后,您可以在您的MCP客户端中输入类似以下的提示词来测试服务器是否正常工作:

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

您的MCP客户端应会启动浏览器并记录一个性能追踪。请注意,MCP服务器只会在MCP客户端调用需要浏览器实例的工具时自动启动浏览器,单独连接到服务器不会自动启动浏览器。

信息

分类

开发者工具