# Chrome DevTools MCP

Canonical: https://cqbase.net/zh/entry/chrome-devtools-mcp
Chinese: https://cqbase.net/zh/entry/chrome-devtools-mcp
English: https://cqbase.net/en/entry/chrome-devtools-mcp

> 让编码代理使用 Chrome 开发者工具，查看正在运行的页面。

ChromeDevTools/chrome-devtools-mcp 是 Apache-2.0 的 MCP 服务器，把 Chrome 开发者工具交给编码代理。代理可以查看真实页面，而不是只凭 HTML 猜测布局。

适合改前端、需要控制台、网络或性能信息的时候。先在本机、对你自己的页面启用，不要把它指向你没有授权去操作的网站后台。

## 解决什么问题

Chrome DevTools MCP（仓库名为 `chrome-devtools-mcp`，官方也称为 Chrome DevTools for agents）让编码代理控制并检查一个正在运行的 Chrome 浏览器。它可以做页面自动化、调试和性能分析，依据的是 Chrome 开发者工具，而不是只靠模型「想象」页面长什么样。

官方说明：它同时提供 MCP 服务器和命令行。本文以接到 Claude Code 或 Cursor 的 MCP 为主。连接 MCP 本身不会自动打开浏览器；只有代理真正调用需要浏览器的工具时，服务器才会启动 Chrome。

## 适合谁

适合已经在用支持 MCP 的编码代理，并需要查看真实页面、录制性能轨迹或排查前端问题的人。它需要本机安装当前稳定版 Chrome，以及 Node.js 的最新 LTS 和 npm。官方只支持 Google Chrome 和 Chrome for Testing；其他基于 Chromium 的浏览器「也许能用，但不保证」。

这套工具本身是开源的，Apache-2.0 许可，官方入门配置不要求单独的 API key。它会把浏览器里的内容暴露给代理，官方警告：不要让它使用你已登录、含敏感信息的会话。Google 默认会收集工具调用成功率等用量统计，可用 `--no-usage-statistics` 关闭；这与 Chrome 浏览器自己的统计是分开的。

## 怎么装

核验日期为 2026-11-15（Asia/Shanghai），命令来自仓库 README、[Client Configurations](https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/client-configurations.md) 和 [Chrome 官方文档](https://developer.chrome.com/docs/devtools/agents/get-started)。通用配置：

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

在 Cursor 中，打开 Cursor Settings → MCP → New MCP Server，填入上述配置。

在 Claude Code 中，若只要 MCP，可在终端执行：

```bash
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
```

若还要一并安装技能，官方插件命令是：

```text
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins
```

官方提醒：如果以前已经为 Claude Code 装过这个 MCP，先从配置里移除再装插件。装完后重启，可用 `/skills` 检查。若插件安装出现 `Failed to clone repository`，见下一节，或改用上面的 `claude mcp add`（这样不会附带技能）。

## 一个实际例子

官方用来验证安装的提示词是：`Check the performance of https://developers.chrome.com`。本次没有在本机实跑，因此不编造轨迹数字或截图。

1. 确认已安装当前稳定版 Chrome，以及 Node.js LTS，并按上一节完成客户端配置。
2. 在代理里发送这句官方提示词。
3. 按官方说明，客户端应打开浏览器并录制一次性能轨迹。MCP 连上之后，要等到代理调用需要浏览器的工具，窗口才会出现。
4. 请自己看轨迹和页面是否确实打开。不要把未实测的结果写进报告，也不要在已登录的个人账号页面上做这个试验。

## 常见坑

- 浏览器内容会被代理看到。官方安全说明写得很直接：代理可以读取、检查和修改浏览器里的数据。不要把它连到你正在使用的、已登录的个人或公司会话。
- 插件无法克隆仓库。官方排障页记录：若环境访问不了 `github.com` 的 443 端口，安装可能失败并出现 `Failed to clone repository`。文档给出的办法是改用 SSH 访问 GitHub，或改走 `claude mcp add` 这条不需要 git clone 的路径。
- 在 WSL 里找不到可用的 Chrome。官方排障写明，默认需要在 Linux 环境里安装 Chrome；从 WSL 启动 Windows 侧 Chrome 目前会因已知问题失败，并指向 [WSL issue #14201](https://github.com/microsoft/WSL/issues/14201)。相关讨论见 [chrome-devtools-mcp#131](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/131)。
- Windows 上找不到 `chrome.exe`。[issue #148](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/148) 报告过 64 位 Windows 定位浏览器失败。请确认安装的是官方支持的 Chrome，而不是未经支持的套壳浏览器。
- 在 Claude Code 里连不上。[issue #182](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/182) 讨论过连接失败。可先用 `claude mcp list` 或 `/mcp` 看服务器状态，并确认 Node 与 Chrome 版本满足要求。

## FAQ

### 需要 API key 吗？

官方入门配置不要求单独的 API key。你需要的是本机的 Chrome、Node.js LTS，以及一个支持 MCP 的客户端。用量统计默认开启，可用 `--no-usage-statistics` 关闭。

### 可以用 Edge 或 Arc 吗？

官方只支持 Google Chrome 和 Chrome for Testing。其他基于 Chromium 的浏览器可能能用，但不保证，出问题需自行判断。

### 连上之后为什么没有弹出窗口？

官方写明：仅仅连上 MCP 不会自动启动浏览器。要等代理调用需要浏览器的工具时，服务器才会打开 Chrome。

### 技能必须装吗？

不必。`claude mcp add` 或通用 JSON 只安装 MCP。插件会额外带上技能；技能需要与服务器版本一起更新，否则可能指向已经改过的工具参数。

### 在公司网络下装插件失败怎么办？

若报错是访问不了 `github.com:443`，先看官方排障里的 SSH 或 `claude mcp add` 替代办法。本文不讨论官方文档之外的网络绕过方式。

## 来源与许可

仓库 [ChromeDevTools/chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp) 使用 Apache-2.0 许可。本文依据 2026-11-15 查阅的 README、客户端配置、[排障文档](https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/troubleshooting.md) 和 [Chrome for Developers 入门页](https://developer.chrome.com/docs/devtools/agents/get-started)，用自己的话写成，供 CQBase 上下文库使用。若安装命令有变，以仓库和官网为准。

## 收录信息

- 作者: ChromeDevTools
- 许可证: Apache-2.0
- 来源: https://github.com/ChromeDevTools/chrome-devtools-mcp
- 收录: 2026-11-15
- GitHub 星标: 56538（采集 2026-11-15）

