Chrome MCP Docker

Chrome MCP Docker

持久化Chrome DevTools MCP服务器

*用于AI编码助手的稳定、持久的Chrome DevTools。*

______________________________________________________________________

为什么选择Docker？

______________________________________________________________________

安装

选项A：独立（推荐）

仅适用于Docker，无需额外依赖。

# 1. Start Chrome container
docker run -d --name chrome-persistent --restart unless-stopped \
  -p 9222:9222 --shm-size=2g \
  zenika/alpine-chrome:with-puppeteer \
  --no-sandbox --remote-debugging-address=0.0.0.0 \
  --remote-debugging-port=9222 --disable-gpu --headless

# 2. Add to Claude Code (~/.claude.json)

{
  "mcpServers": {
    "chrome": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--network", "host",
               "-e", "CHROME_HOST=localhost", "-e", "CHROME_PORT=9222",
               "nullrunner/chrome-mcp-docker:latest"]
    }
  }
}

选项B：Docker MCP网关

警告：官方的Docker MCP网关存在影响自定义服务器的错误。 看 已知问题.使用选项A或下面的修补叉。

# Use patched fork (recommended if you want Gateway)
git clone https://github.com/null-runner/mcp-gateway.git
cd mcp-gateway && go build -o docker-mcp ./cmd/docker-mcp

# Then setup chrome-mcp-docker
git clone https://github.com/null-runner/chrome-mcp-docker.git
cd chrome-mcp-docker
./setup.sh

______________________________________________________________________

工具

______________________________________________________________________

需求

• 码头工人 （其中之一）：

- （Windows/Mac-最简单） - Docker引擎（Linux-请参阅 安装指南) - 波德曼（兼容替代品）

• 任何兼容MCP的客户端（Claude Code、Cursor、Windsurf、Cline等）

______________________________________________________________________

文档

• 安装指南 -手动安装、配置选项
• 故障排除 -常见问题和修复
• 建筑 -引擎盖下的工作原理

______________________________________________________________________

运作原理

AI Coding Assistant (Claude, Cursor, etc.)
    ↓
chrome-mcp-docker (MCP Server)
    ↓
Chrome DevTools Protocol
    ↓
Persistent Chrome Browser (Docker)

关键创新： 主机头旁路.Chrome拒绝来自Docker容器的连接，因为 host.docker.internal 不是 localhost。此服务器会伪造标头。

______________________________________________________________________

已知问题

Docker MCP网关 有几个影响自定义服务器的开放错误：

• 产品编号263 -工具名称前缀分隔符(: → __)
• 产品编号278 -发送到远程服务器的前缀名称
• 产品编号279 -Claude客户端被排除在工具激活之外

推荐：在合并这些PR之前，使用独立安装（选项A）。

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

由以下材料制成☕ 通过 空转轮