chrome-devtools-mcp-bridge

一个小型桥梁，使得沙箱中的MCP客户端可以与运行在外部的chrome-devtools-mcp进行通信，并自动启动无头模式的Chrome。该包包含两个子命令：

• chrome-devtools-mcp-bridge host — 运行一个TCP服务；对于每个连接，它会启动chrome-devtools-mcp和一个无头Chrome，然后通过TCP <-> MCP标准输入输出进行数据传输。
• chrome-devtools-mcp-bridge connect — 将标准输入输出连接到TCP服务；适用于期望使用标准输入输出的MCP客户端（例如，Codex CLI）。

为什么需要这个工具？

• 解决沙箱中MCP客户端（如Ubuntu或容器中的Codex）的问题，其中chrome-devtools-mcp无法启动Chrome，因为操作系统沙箱的限制。典型错误信息包括：
  • "某些MCP客户端允许沙箱化MCP服务器……作为解决方法，要么禁用沙箱……或者使用--connect-url"
  • "从http://localhost:9222/json/version获取浏览器webSocket URL失败：请求失败"
  • "浏览器已经在/home/me/.cache/chrome-devtools-mcp/chrome-profile运行。使用--isolated来运行多个浏览器实例。"
• 桥接WSL Linux和Windows主机：在Windows上运行host，从WSL连接connect以驱动Windows Chrome DevTools。

默认设置

• 主机：127.0.0.1
• 端口：8211
• MCP命令：npx -y -p chrome-devtools-mcp@latest chrome-devtools-mcp
• Chrome：自动检测（google-chrome/chromium…）；无头模式；临时配置文件。

快速开始（无需安装）

1. 启动桥梁（在沙箱外）： npx -y chrome-devtools-mcp-bridge@latest host

2. 连接你的MCP客户端（在沙箱或容器内）： codex mcp add chrome-devtools -- npx -y chrome-devtools-mcp-bridge@latest connect

提示：在受限环境中保持npx缓存本地 XDG_CACHE_HOME=$PWD/.cache NPM_CONFIG_CACHE=$PWD/.npm-cache npx -y chrome-devtools-mcp-bridge@latest host

没有别名——保持简单：只有'host'和'connect'。

守护进程 vs nohup

• 推荐使用--daemon（写入PID，支持--log-file）。
• 如果必须使用nohup/setsid：
  • nohup npx -y chrome-devtools-mcp-bridge@latest host > mcp-bridge.log 2>&1 & echo $! > mcp-bridge.pid
  • setsid npx -y chrome-devtools-mcp-bridge@latest host >/dev/null 2>&1 < /dev/null &

环境变量/标志

• --host / --port: 覆盖默认值
• --no-sandbox: 使用--no-sandbox启动Chrome（仅限开发用途）
• --chrome-bin <路径>: 显式指定Chrome可执行文件
• --mcp-cmd <命令>: 覆盖MCP启动器（默认：npx）
• --mcp-args "...": 额外参数（默认通过npx拉取chrome-devtools-mcp）。原生 chrome-devtools-mcp标志如--isolated / --connect-url=...将原样传递， 因此你可以选择不使用自动启动的Chrome。你也可以在桥接选项之后添加任何额外的 chrome-devtools-mcp标志（例如，chrome-devtools-mcp-bridge host -- --isolated --foo=bar），它们将被原样转发。

WSL ↔ Windows 如果主机/端口正确路由了WSL和Windows之间的通信，这可以桥接WSL MCP到Windows Chrome。在现代WSL2中，Windows回环地址通常会被镜像，因此localhost经常能工作；否则，使用Windows主机IP（通过ipconfig.exe获取）并在Windows防火墙中允许该端口。