MCP
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 和 Chrome 官方文档。通用配置:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}在 Cursor 中,打开 Cursor Settings → MCP → New MCP Server,填入上述配置。
在 Claude Code 中,若只要 MCP,可在终端执行:
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest若还要一并安装技能,官方插件命令是:
/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。本次没有在本机实跑,因此不编造轨迹数字或截图。
- 确认已安装当前稳定版 Chrome,以及 Node.js LTS,并按上一节完成客户端配置。
- 在代理里发送这句官方提示词。
- 按官方说明,客户端应打开浏览器并录制一次性能轨迹。MCP 连上之后,要等到代理调用需要浏览器的工具,窗口才会出现。
- 请自己看轨迹和页面是否确实打开。不要把未实测的结果写进报告,也不要在已登录的个人账号页面上做这个试验。
常见坑
- 浏览器内容会被代理看到。官方安全说明写得很直接:代理可以读取、检查和修改浏览器里的数据。不要把它连到你正在使用的、已登录的个人或公司会话。
- 插件无法克隆仓库。官方排障页记录:若环境访问不了
github.com的 443 端口,安装可能失败并出现Failed to clone repository。文档给出的办法是改用 SSH 访问 GitHub,或改走claude mcp add这条不需要 git clone 的路径。 - 在 WSL 里找不到可用的 Chrome。官方排障写明,默认需要在 Linux 环境里安装 Chrome;从 WSL 启动 Windows 侧 Chrome 目前会因已知问题失败,并指向 WSL issue #14201。相关讨论见 chrome-devtools-mcp#131。
- Windows 上找不到
chrome.exe。issue #148 报告过 64 位 Windows 定位浏览器失败。请确认安装的是官方支持的 Chrome,而不是未经支持的套壳浏览器。 - 在 Claude Code 里连不上。issue #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 使用 Apache-2.0 许可。本文依据 2026-11-15 查阅的 README、客户端配置、排障文档 和 Chrome for Developers 入门页,用自己的话写成,供 CQBase 上下文库使用。若安装命令有变,以仓库和官网为准。