Chrome DevTools MCP

面向 Agent 的 Chrome DevTools

面向 Agent 的 Chrome DevTools（chrome-devtools-mcp）可让你的编码 Agent（例如 Antigravity、Claude、Cursor 或 Copilot） 控制并检查正在运行的 Chrome 浏览器。它作为 Model-Context-Protocol （MCP）服务运行，让你的 AI 编码助手能够充分利用 Chrome DevTools 的强大功能，进行可靠的自动化、深入调试和性能分析。 它还提供了一个 CLI，可在不使用 MCP 的情况下使用。

此仓库以 @async23/chrome-devtools-mcp 的名称发布 Async23 分支。它包含本地可见浏览器的焦点控制和超大整页截图修复，同时保留 chrome-devtools-mcp 可执行文件名称。

工具参考 | 更新日志 | 贡献指南 | 故障排除 | 设计原则

主要功能

• 获取性能洞察：使用 Chrome DevTools 记录 跟踪数据并提取可执行的性能洞察。
• 高级浏览器调试：分析网络请求、截取屏幕截图，并检查浏览器控制台消息（包含源映射堆栈跟踪）。
• 可靠的自动化：使用 puppeteer 自动执行 Chrome 中的操作，并自动等待操作结果。

免责声明

chrome-devtools-mcp 会向 MCP 客户端公开浏览器实例的内容， 使其能够检查、调试并修改浏览器或 DevTools 中的任何数据。 请避免分享你不希望 MCP 客户端获知的敏感或个人信息。

chrome-devtools-mcp 仅正式支持 Google Chrome 和 Chrome for Testing。 其他基于 Chromium 的浏览器可能可以使用，但不作保证，并且可能会遇到意外行为。请自行决定是否使用。 我们致力于为最新版本的 Extended Stable Chrome 提供修复和支持。

性能工具可能会将跟踪 URL 发送到 Google CrUX API，以获取真实用户体验数据。这有助于通过同时呈现现场数据和实验室数据，全面了解性能情况。该数据由 Chrome 用户体验报告（CrUX）收集。如需停用此功能，请使用 --no-performance-crux 标志运行。

使用统计信息

Google 会收集使用统计信息（例如工具调用成功率、延迟和环境信息），以提升 Chrome DevTools MCP 的可靠性和性能。

默认情况下，数据收集处于启用状态。启动服务时传入 --no-usage-statistics 标志即可选择退出：

"args": ["-y", "@async23/chrome-devtools-mcp@latest", "--no-usage-statistics"]

Google 会根据《Google 隐私权政策》处理这些数据。

Google 对 Chrome DevTools MCP 使用统计信息的收集独立于 Chrome 浏览器的使用统计信息。选择退出 Chrome 指标不会自动让你退出此工具的数据收集，反之亦然。

如果设置了 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI 环境变量，则会停用数据收集。

更新检查

默认情况下，服务会定期检查 npm 注册表是否有更新，并在发现新版本时记录通知。 你可以通过设置 CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS 环境变量来停用更新检查。

要求

• Node.js LTS 版本。
• Chrome 当前稳定版或更新版本。
• npm

入门

将以下配置添加到你的 MCP 客户端：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "@async23/chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222",
        "--no-emulate-focused-pages"
      ]
    }
  }
}

说明

使用 @async23/chrome-devtools-mcp@latest 可确保 MCP 客户端 始终使用此分支的最新已发布版本。上述配置要求已有一个可调试的 Chrome 实例运行在端口 9222。

如果你只想执行基本的浏览器任务，请使用 --slim 模式：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "@async23/chrome-devtools-mcp@latest",
        "--slim",
        "--headless"
      ]
    }
  }
}

请参阅 精简工具参考。

MCP 客户端配置

amp mcp add chrome-devtools -- npx @async23/chrome-devtools-mcp@latest

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "@async23/chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

claude mcp add chrome-devtools --scope user npx @async23/chrome-devtools-mcp@latest

/plugin marketplace add Async23/chrome-devtools-mcp

/plugin install chrome-devtools-mcp@chrome-devtools-plugins

codex mcp add chrome-devtools -- npx @async23/chrome-devtools-mcp@latest

[mcp_servers.chrome-devtools]
command = "cmd"
args = [
    "/c",
    "npx",
    "-y",
    "@async23/chrome-devtools-mcp@latest",
]
env = { SystemRoot="C:\\Windows", PROGRAMFILES="C:\\Program Files" }
startup_timeout_ms = 20_000

cmd mcp add chrome-devtools --scope user npx @async23/chrome-devtools-mcp@latest

copilot

/mcp add

code --add-mcp '{"name":"io.github.Async23/chrome-devtools-mcp","command":"npx","args":["-y","@async23/chrome-devtools-mcp@latest"],"env":{}}'

code --add-mcp '{"""name""":"""io.github.Async23/chrome-devtools-mcp""","""command""":"""npx""","""args""":["""-y""","""@async23/chrome-devtools-mcp@latest"""]}'

droid mcp add chrome-devtools "npx -y @async23/chrome-devtools-mcp@latest"

# Either MCP only:
gemini mcp add chrome-devtools npx @async23/chrome-devtools-mcp@latest
# Or as a Gemini extension (MCP+Skills):
gemini extensions install --auto-update https://github.com/Async23/chrome-devtools-mcp

gemini mcp add -s user chrome-devtools npx @async23/chrome-devtools-mcp@latest

grok mcp add chrome-devtools npx @async23/chrome-devtools-mcp@latest

mcp-proxy --transport streamablehttp --port 8080 -- npx -y @async23/chrome-devtools-mcp@latest

[[mcp_servers]]
name = "chrome-devtools"
transport = "stdio"
command = "npx"
args = ["@async23/chrome-devtools-mcp@latest"]

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "chrome-devtools": {
      "type": "local",
      "command": ["npx", "-y", "@async23/chrome-devtools-mcp@latest"]
    }
  }
}

qodercli mcp add chrome-devtools -- npx @async23/chrome-devtools-mcp@latest

qodercli mcp add -s user chrome-devtools -- npx @async23/chrome-devtools-mcp@latest

第一个提示词

在 MCP 客户端中输入以下提示词，检查一切是否正常：

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

MCP 客户端应打开浏览器并记录性能跟踪。

说明

MCP 客户端使用需要运行中的浏览器实例的工具后，MCP 服务会自动启动浏览器。仅连接到 Chrome DevTools MCP 服务不会自动启动浏览器。

工具

如果遇到问题，请查看我们的故障排除指南。

• 输入自动化（10 个工具）
  • click
  • drag
  • fill
  • fill_form
  • handle_dialog
  • hover
  • press_key
  • type_text
  • upload_file
  • click_at
• 导航自动化（6 个工具）
  • close_page
  • list_pages
  • navigate_page
  • new_page
  • select_page
  • wait_for
• 模拟（2 个工具）
  • emulate
  • resize_page
• 性能（3 个工具）
  • performance_analyze_insight
  • performance_start_trace
  • performance_stop_trace
• 网络（2 个工具）
  • get_network_request
  • list_network_requests
• 调试（8 个工具）
  • evaluate_script
  • get_console_message
  • lighthouse_audit
  • list_console_messages
  • take_screenshot
  • take_snapshot
  • screencast_start
  • screencast_stop
• 内存（11 个工具）
  • take_heapsnapshot
  • close_heapsnapshot
  • compare_heapsnapshots
  • get_heapsnapshot_class_nodes
  • get_heapsnapshot_details
  • get_heapsnapshot_dominators
  • get_heapsnapshot_duplicate_strings
  • get_heapsnapshot_edges
  • get_heapsnapshot_retainers
  • get_heapsnapshot_retaining_paths
  • get_heapsnapshot_summary
• 扩展程序（5 个工具）
  • install_extension
  • list_extensions
  • reload_extension
  • trigger_extension_action
  • uninstall_extension
• 第三方（2 个工具）
  • execute_3p_developer_tool
  • list_3p_developer_tools
• WebMCP（2 个工具）
  • execute_webmcp_tool
  • list_webmcp_tools

配置

Chrome DevTools MCP 服务支持以下配置选项：

• --autoConnect/ --auto-connect 如果指定，则自动连接到通过 channel 参数指定的用户数据目录中本地运行的浏览器（Chrome 144+，默认 channel 为 stable）。需要通过 chrome://inspect/#remote-debugging 在 Chrome 实例中启动远程调试服务器。

  • 类型： boolean
  • 默认值： false

• --browserUrl/ --browser-url, -u 连接到正在运行且可调试的 Chrome 实例（例如 http://127.0.0.1:9222）。详情请参阅：https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance。

  • 类型： string
  • 默认值： false

• --wsEndpoint/ --ws-endpoint, -w 用于连接到正在运行的 Chrome 实例的 WebSocket 端点（例如 ws://127.0.0.1:9222/devtools/browser/）。可替代 --browserUrl。

  • 类型： string
  • 默认值： false

• --wsHeaders/ --ws-headers WebSocket 连接的自定义标头，采用 JSON 格式（例如 '{"Authorization":"Bearer token"}'）。仅在使用 --wsEndpoint 时有效。

  • 类型： string
  • 默认值： false

• --headless 是否以无头（无 UI）模式运行。

  • 类型： boolean
  • 默认值： false

• --executablePath/ --executable-path, -e 自定义 Chrome 可执行文件的路径。

  • 类型： string
  • 默认值： false

• --isolated 如果指定，则创建一个临时 user-data-dir，并在浏览器关闭后自动清理。默认为 false。

  • 类型： boolean
  • 默认值： false

• --userDataDir/ --user-data-dir Chrome 用户数据目录的路径。默认值为 $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE

  • 类型： string
  • 默认值： false

• --channel 指定要使用的其他 Chrome channel。默认使用 stable channel 版本。

  • 类型： string
  • 选项： canary, dev, beta, stable
  • 默认值： false

• --logFile/ --log-file 用于写入调试日志的文件路径。将环境变量 DEBUG 设为 * 可启用详细日志。适用于提交错误报告。

  • 类型： string
  • 默认值： false

• --viewport 服务启动的 Chrome 实例的初始视口尺寸。例如，1280x720。在无头模式下，最大尺寸为 3840x2160px。

  • 类型： string
  • 默认值： false

• --proxyServer/ --proxy-server Chrome 的代理服务器配置，启动浏览器时会作为 --proxy-server 传入。详情请参阅 https://www.chromium.org/developers/design-documents/network-settings/。

  • 类型： string
  • 默认值： false

• --acceptInsecureCerts/ --accept-insecure-certs 如果启用，则忽略与自签名证书和过期证书相关的错误。请谨慎使用。

  • 类型： boolean
  • 默认值： false

• --experimentalPageIdRouting/ --experimental-page-id-routing 是否在页面级工具中公开 pageId，并按页面 ID 路由请求（适用于并发 Agent 会话）。

  • 类型： boolean
  • 默认值： false

• --experimentalDevtools/ --experimental-devtools 是否启用通过 DevTools targets 进行自动化

  • 类型： boolean
  • 默认值： false

• --experimentalVision/ --experimental-vision 是否启用基于坐标的工具，例如 click_at(x,y)。通常需要能够通过查看屏幕截图生成准确坐标的计算机操作模型。

  • 类型： boolean
  • 默认值： false

• --memoryDebugging/ --memory-debugging, -experimentalMemory 是否启用内存调试工具。

  • 类型： boolean
  • 默认值： false

• --experimentalStructuredContent/ --experimental-structured-content 是否输出结构化格式的内容。

  • 类型： boolean
  • 默认值： false

• --experimentalIncludeAllPages/ --experimental-include-all-pages 是否将所有类型的页面（如 WebView 或后台页面）都作为页面纳入。

  • Type: 布尔值
  • Default: false

• --emulateFocusedPages/ --emulate-focused-pages 是否将页面模拟为已聚焦且处于活动状态。仅当可见浏览器的焦点行为出现问题时才禁用；保持启用可保留多 Agent 工作流中的现有行为，使页面表现为已聚焦/处于活动状态。

  • Type: 布尔值
  • Default: true

• --experimentalScreencast/ --experimental-screencast 开放实验性屏幕录制工具（需要 ffmpeg）。请从 https://www.ffmpeg.org/download.html 安装 ffmpeg，并确保它位于 MCP 服务的 PATH 中。

  • Type: 布尔值
  • Default: false

• --experimentalFfmpegPath/ --experimental-ffmpeg-path 用于屏幕录制的 ffmpeg 可执行文件路径。

  • Type: 字符串
  • Default: false

• --categoryExperimentalWebmcp/ --category-experimental-webmcp 设为 true 可启用 WebMCP 调试工具。需要 Chrome 149+，并启用以下标志：--enable-features=WebMCP,DevToolsWebMCPSupport

  • Type: 布尔值
  • Default: false

• --chromeArg/ --chrome-arg Chrome 的其他参数。仅在由 chrome-devtools-mcp 启动 Chrome 时生效。

  • Type: 数组
  • Default: false

• --blockedUrlPattern/ --blocked-url-pattern 通过屏蔽指定的 URL 模式来限制浏览器的网络访问（使用 https://urlpattern.spec.whatwg.org/）。连接时会静默断开与含有被屏蔽 URL 的目标的连接，并屏蔽运行时请求（包括导航和子资源请求）。接受模式数组。

  • Type: 数组
  • Default: false

• --allowedUrlPattern/ --allowed-url-pattern 通过仅允许指定的 URL 模式来限制浏览器的网络访问（使用 https://urlpattern.spec.whatwg.org/）。需要 Chrome 149+。连接时会静默断开与含有未允许 URL 的目标的连接，并屏蔽运行时请求（包括导航和子资源请求）。接受模式数组。

  • Type: 数组
  • Default: false

• --ignoreDefaultChromeArg/ --ignore-default-chrome-arg 明确禁用 Chrome 的默认参数。仅在由 chrome-devtools-mcp 启动 Chrome 时生效。

  • Type: 数组
  • Default: false

• --categoryEmulation/ --category-emulation 设为 false 可排除与模拟相关的工具。

  • Type: 布尔值
  • Default: true

• --categoryPerformance/ --category-performance 设为 false 可排除与性能相关的工具。

  • Type: 布尔值
  • Default: true

• --categoryNetwork/ --category-network 设为 false 可排除与网络相关的工具。

  • Type: 布尔值
  • Default: true

• --categoryExtensions/ --category-extensions 设为 true 可包含与扩展相关的工具。注意：此功能目前仅支持管道连接。在 149 发布之前，此功能不支持 autoConnect、browserUrl 和 wsEndpoint。

  • Type: 布尔值
  • Default: false

• --categoryExperimentalThirdParty/ --category-experimental-third-party 设为 true 可启用由被检查页面本身开放的第三方开发者工具。

  • Type: 布尔值
  • Default: false

• --performanceCrux/ --performance-crux 设为 false 可停止将性能跟踪中的 URL 发送到 CrUX API，以获取现场性能数据。

  • Type: 布尔值
  • Default: true

• --usageStatistics/ --usage-statistics 设置为 false 可选择退出使用情况统计信息收集。Google 会根据 Google 隐私权政策 (https://policies.google.com/privacy) 处理收集到的使用数据，以改进工具。这与 Chrome 浏览器指标相互独立。如果设置了 CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS 或 CI 环境变量，则会禁用此功能。

  • 类型： boolean
  • 默认值： true

• --screenshotFormat/ --screenshot-format 当调用方未指定格式时，覆盖 take_screenshot 使用的默认输出格式。JPEG 和 WebP 的文件大小约为 PNG 的 1/3 到 1/5，有助于减小 AI 对话中的上下文大小。未设置时保留现有默认值（"png"）。

  • 类型： string
  • 可选值： jpeg、png、webp
  • 默认值： false

• --screenshotQuality/ --screenshot-quality 当调用方未指定质量时，覆盖 take_screenshot 为 JPEG 和 WebP 使用的默认压缩质量（0-100）。值越低，文件越小。对 PNG 无效。未设置时保留 Puppeteer 默认值。

  • 类型： number
  • 默认值： false

• --screenshotMaxWidth/ --screenshot-max-width 截图的最大宽度（像素）。如果捕获的图像宽度超过此值，则会在返回前缩小图像（保持宽高比）。这有助于减小 AI 对话中的上下文大小。未设置时不调整大小。

  • 类型： number
  • 默认值： false

• --screenshotMaxHeight/ --screenshot-max-height 截图的最大高度（像素）。如果捕获的图像高度超过此值，则会在返回前缩小图像（保持宽高比）。可与 --screenshot-max-width 结合使用；以较小的缩放比例为准。未设置时不调整大小。

  • 类型： number
  • 默认值： false

• --slim 仅公开一组精简的 3 个工具，涵盖导航、脚本执行和截图。适用于基本的浏览器任务。

  • 类型： boolean
  • 默认值： false

• --redactNetworkHeaders/ --redact-network-headers 如果为 true，则在返回给客户端之前，隐藏部分被视为敏感信息的网络标头。

  • 类型： boolean
  • 默认值： false

• --allowUnrestrictedPaths/ --allow-unrestricted-paths 如果设置，则在 MCP 客户端未协商 roots 能力时，禁用默认的路径限制。默认情况下，如果未配置 roots，文件写入工具仅可访问操作系统临时目录。仅在连接可信的本地客户端，且该客户端未实现 MCP roots、需要访问临时目录以外的路径时使用此选项。

  • 类型： boolean
  • 默认值： false

通过 JSON 配置中的 args 属性传递这些参数。例如：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "@async23/chrome-devtools-mcp@latest",
        "--channel=canary",
        "--headless=true",
        "--isolated=true"
      ]
    }
  }
}

使用自定义标头通过 WebSocket 连接

你可以直接连接到 Chrome WebSocket 端点，并附带自定义标头（例如，用于身份验证）：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "@async23/chrome-devtools-mcp@latest",
        "--wsEndpoint=ws://127.0.0.1:9222/devtools/browser/<id>",
        "--wsHeaders={\"Authorization\":\"Bearer YOUR_TOKEN\"}"
      ]
    }
  }
}

要从运行中的 Chrome 实例获取 WebSocket 端点，请访问 http://127.0.0.1:9222/json/version 并查找 webSocketDebuggerUrl 字段。

你也可以运行 npx @async23/chrome-devtools-mcp@latest --help，查看所有可用的配置选项。

概念

并发会话

大多数 MCP 客户端会为每个对话启动一个 Chrome DevTools MCP 服务。如果你的客户端在多个并发 Agent 或子 Agent 之间共享同一个服务实例，请使用 --experimentalPageIdRouting 启动服务。这样，页面级工具会公开 pageId，以便每个 Agent 将工具调用路由到自己正在操作的标签页。

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

如果你运行多个相互独立的 MCP 客户端会话，并希望每个会话都启动独立的临时 Chrome 配置文件，也请传递 --isolated。这样可避免这些服务实例共享默认的 Chrome DevTools MCP 用户数据目录。

用户数据目录

chrome-devtools-mcp 会使用以下用户数据目录启动 Chrome 稳定版：

• Linux / macOS：$HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL
• Windows：%HOMEPATH%/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL

每次运行之间不会清除用户数据目录，且所有 chrome-devtools-mcp 实例共享该目录。将 isolated 选项设为 true，即可改用临时用户数据目录，并在浏览器关闭后自动清除。

连接到正在运行的 Chrome 实例

默认情况下，Chrome DevTools MCP 服务会使用专用配置文件启动一个新的 Chrome 实例。在某些情况下，这可能并不理想：

• 如果你希望在手动测试网站和由 Agent 驱动的测试之间切换时，保留相同的应用状态。
• MCP 需要登录网站时。有些账户可能会阻止通过 WebDriver（Chrome DevTools MCP 服务的默认启动机制）控制浏览器时的登录。
• 如果你在沙盒环境中运行大模型，但希望连接到沙盒之外运行的 Chrome 实例。

遇到这些情况时，请先启动 Chrome，再让 Chrome DevTools MCP 服务连接到它。可以通过以下两种方式实现：

• 自动连接（Chrome 144 起可用）：最适合在手动测试和由 Agent 驱动的测试之间共享状态。
• 通过远程调试端口手动连接：最适合在沙盒环境中运行时使用。

自动连接到正在运行的 Chrome 实例

**步骤 1：**在 Chrome 中设置远程调试

在 Chrome（>= M144）中，执行以下操作来设置远程调试：

1. 前往 chrome://inspect/#remote-debugging 启用远程调试。
2. 按照对话框界面提示，允许或拒绝传入的调试连接。

**步骤 2：**配置 Chrome DevTools MCP 服务，以便自动连接到正在运行的 Chrome 实例

若要将 chrome-devtools-mcp 服务连接到正在运行的 Chrome 实例，请为 MCP 服务使用 --autoConnect 命令行参数。

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

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

**步骤 3：**测试设置

确保浏览器正在运行。打开 gemini-cli 并运行以下提示词：

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

说明

autoConnect 选项要求用户启动 Chrome。如果用户有多个活跃配置文件，MCP 服务将连接到默认配置文件（由 Chrome 确定）。MCP 服务可以访问所选配置文件中的所有打开窗口。

Chrome DevTools MCP 服务会尝试连接到正在运行的 Chrome 实例。系统会显示一个对话框，请求用户许可。

点击 允许后，Chrome DevTools MCP 服务会打开 developers.chrome.com，并采集性能 跟踪记录。

使用端口转发手动连接

你可以使用 --browser-url 选项连接到正在运行的 Chrome 实例。如果你在不允许启动新 Chrome 实例的沙盒环境中运行 MCP 服务，这会很有用。

以下是连接到正在运行的 Chrome 实例的分步指南：

步骤 1：配置 MCP 客户端

在 MCP 客户端配置中添加 --browser-url 选项。此选项的值应为正在运行的 Chrome 实例的 URL。http://127.0.0.1:9222 是常见的默认值。

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "@async23/chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

步骤 2：启动 Chrome 浏览器

警告

启用远程调试端口会在正在运行的浏览器实例上开放一个调试端口。你机器上的任何应用都可以连接到此端口并控制浏览器。调试端口开放期间，请勿浏览任何敏感网站。

启动 Chrome 浏览器并启用远程调试端口。启用调试端口启动新的 Chrome 实例前，请确保关闭所有正在运行的 Chrome 实例。你选择的端口号必须与 MCP 客户端配置中 --browser-url 选项指定的端口号相同。

出于安全原因，启用远程调试端口时，Chrome 要求使用非默认用户数据目录。你可以使用 --user-data-dir 标志指定自定义目录。这样可以确保常规浏览配置文件和数据不会暴露给调试会话。

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

Linux

/usr/bin/google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

Windows

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%TEMP%\chrome-profile-stable"

步骤 3：测试设置

配置 MCP 客户端并启动 Chrome 浏览器后，你可以在 MCP 客户端中运行一个简单的提示词来测试设置：

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

MCP 客户端应连接到正在运行的 Chrome 实例并接收性能报告。

如果遇到虚拟机到主机的端口转发问题，请参阅 docs/troubleshooting.md 中的“虚拟机 (VM) 与主机之间的远程调试失败”部分。

有关远程调试的更多详情，请参阅 Chrome DevTools 文档。

在 Android 上调试 Chrome

请参阅这些说明。

已知限制

请参阅故障排除。

集成为浏览器子 Agent

如果你正在开发 Agent 工具，并希望将集成式浏览器子 Agent 作为产品的一部分提供，我们建议基于 Chrome DevTools for agents 构建。

参考实现请参阅 Gemini CLI 浏览器 Agent 文档。