让编码智能体使用 Chrome DevTools MCP 调试您的浏览器会话

发布时间:2025 年 12 月 11 日

我们对 Chrome 开发者工具 MCP 服务器进行了一项增强,许多用户一直要求我们实现这项增强功能:让编码代理能够直接连接到活跃的浏览器会话。

通过此增强功能,编码智能体能够:

  1. 重复使用现有浏览器会话:假设您希望编码智能体修复登录后才能访问的问题。您的编码代理现在可以直接访问您当前的浏览会话,无需额外登录。
  2. 访问活跃的调试会话:编码代理现在可以在开发者工具界面中访问活跃的调试会话。例如,当您在 Chrome 开发者工具的网络面板中发现失败的网络请求时,可以选择该请求,然后让编码代理调查该请求。对于在“元素”面板中选择的元素,此方法同样适用。我们很高兴能推出这项新功能,让开发者可以在手动调试和 AI 辅助调试之间无缝切换。

查看实际运作方式:

自动连接功能是对 Chrome DevTools MCP 连接到 Chrome 实例的现有方式的补充。请注意,您仍然可以:

  • 运行 Chrome,并使用 Chrome 开发者工具 MCP 服务器专用的用户个人资料(当前默认)。
  • 连接到具有远程调试端口的正在运行的 Chrome 实例。
  • 以隔离方式运行多个 Chrome 实例,每个实例都在临时个人资料中运行。

运作方式

我们在 Chrome M145(目前为 Canary 版)中添加了一项新功能,可让 Chrome 开发者工具 MCP 服务器请求远程调试连接。这一新流程基于 Chrome 现有的远程调试功能构建而成。默认情况下,Chrome 中会停用远程调试连接。开发者必须先前往 chrome://inspect#remote-debugging 明确启用此功能。

如果 Chrome DevTools MCP 服务器配置了 --autoConnect 选项,则 MCP 服务器将连接到活跃的 Chrome 实例并请求远程调试会话。为避免恶意行为者滥用,每次 Chrome 开发者工具 MCP 服务器请求远程调试会话时,Chrome 都会向用户显示一个对话框,并请求用户授予允许远程调试会话的权限。此外,在调试会话处于活动状态时,Chrome 会在顶部显示“Chrome 正受到自动测试软件的控制”横幅。

远程调试流程:首先启用远程调试功能。然后确认远程调试连接请求。调试会话将通过横幅文本指示。
Chrome 中的新远程调试流程和界面。

开始使用

使用新的远程调试功能。您必须先在 Chrome 中启用远程调试,然后配置 Chrome 开发者工具 MCP 服务器以使用新的自动连接功能。

第 1 步:在 Chrome 中设置远程调试

在 Chrome 中,执行以下操作来设置远程调试:

  1. 前往 chrome://inspect/#remote-debugging 以启用远程调试。
  2. 按照对话框界面中的说明允许或禁止传入的调试连接。
屏幕截图:显示如何在 Chrome 中启用远程调试
在客户端可以请求远程调试连接之前,需要先启用远程调试。

第 2 步:配置 Chrome 开发者工具 MCP 服务器以自动连接到正在运行的 Chrome 实例

如需将 chrome-devtools-mcp 服务器连接到正在运行的 Chrome 实例,请使用 --autoConnect 命令行实参来设置 MCP 服务器。

以下代码段是 gemini-cli 的示例配置:

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

第 3 步:测试设置

现在,打开 gemini-cli 并运行以下提示:

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

Chrome 开发者工具 MCP 服务器将尝试连接到正在运行的 Chrome 实例。它会显示一个对话框,请求用户授予权限:

Chrome 对话框,要求用户启用远程调试会话。
Chrome 请求用户授予启动远程调试会话的权限。

点击允许会导致 Chrome DevTools MCP 服务器打开 developers.chrome.com 并进行性能轨迹分析。

如需查看完整说明,请参阅 GitHub 上的自述文件

让编码代理接管您的调试会话

能够连接到实时 Chrome 实例意味着您不必在自动化和手动控制之间做出选择。您可以自行使用开发者工具,也可以将调试任务交给编码代理。如果您发现网站上存在问题,可以打开开发者工具查看,以找出导致问题的元素。如果您希望编码代理修复问题,现在可以使用 Chrome 开发者工具 MCP 服务器来完成此任务。您可以在“元素”面板中选择相应元素,然后让编码代理调查问题。

同样,此方法也适用于“网络”面板。您可以选择一个网络请求,然后让编码代理调查该请求。

但这只是第一步。我们计划通过 Chrome DevTools MCP 服务器逐步向编码代理公开越来越多的面板数据。敬请期待!