CamoFox MCP Docker Compose

Provenance

This repository is a deployment/package adaptation built on top of upstream open-source projects:

• redf0x1/camofox-browser
• redf0x1/camofox-mcp

The browser server and MCP implementation are not original to this repository. This repo focuses on Docker deployment hardening, offline bundle generation, and operational packaging. See NOTICE.md.

参考 redf0x1/camofox-mcp 的 HTTP 部署方式，这里把：

• camofox-browser
• camofox-mcp

放在同一个 Docker bridge 网络 camofox_net 中通信。

当前仓库默认使用 vendor/ 下的本地源码 build 镜像，而不是直接从 ghcr.io 拉取。 这样可以绕开部分环境下的 GHCR 拉取不稳定问题。

设计约束：

• 只对宿主机暴露 camofox-mcp 的 3100 端口
• camofox-browser 不发布任何宿主机端口，只允许容器内通过 http://camofox-browser:9377 访问
• 浏览器侧使用 CAMOFOX_AUTH_MODE=disabled，这是上游文档建议的“仅私有 Docker 网络内部访问”模式
• MCP HTTP 入口使用 CAMOFOX_HTTP_API_KEY 做 Bearer 鉴权

使用

1. 创建环境变量文件：

cp .env.example .env

2. 修改 .env 中的 CAMOFOX_HTTP_API_KEY，至少 32 位随机字符串。

3. 启动服务：

docker compose up -d

4. 验证容器状态：

docker compose ps

MCP 访问地址

MCP HTTP endpoint:

http://localhost:3100/mcp

请求头：

Authorization: Bearer <你的 CAMOFOX_HTTP_API_KEY>

说明

• camofox-browser 的用户数据持久化在 Docker volume camofox_profiles
• 如果你需要从其他机器访问 3100，把 .env 里的 CAMOFOX_HTTP_ALLOWED_HOSTS 改成对应域名或 IP
• 不要给 camofox-browser 增加 ports 映射；否则就破坏了“仅 MCP server 对外暴露”的隔离要求