camofox-mcp

🚀 CamoFox MCP

CamoFox MCP 是一款由人工智能驱动的反检测浏览器自动化工具，专为与 MCP 兼容的人工智能代理而设计。它能将诸如 Claude Desktop、VS Code、Cursor 和 OpenClaw 等 MCP 客户端连接到 CamoFox 浏览器服务器，为代理提供实用的浏览器工具集，可用于导航、交互、搜索、提取、下载和会话复用，同时依托基于 Camoufox 的反检测行为。

🚀 快速开始

你需要同时运行两个组件：

1. camofox-browser 负责处理反检测浏览器。
2. camofox-mcp 将该浏览器暴露给你的 MCP 客户端。

选项 A：npx + 标准输入输出

启动浏览器服务器：

npx camofox-browser@latest

将 CamoFox MCP 添加到你的 MCP 客户端：

{
  "servers": {
    "camofox": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "camofox-mcp@latest"],
      "env": {
        "CAMOFOX_URL": "http://localhost:9377"
      }
    }
  }
}

选项 B：Docker

启动浏览器服务器：

docker run -d -p 9377:9377 --name camofox-browser ghcr.io/redf0x1/camofox-browser:latest

以 HTTP 模式运行 CamoFox MCP，供 OpenClaw 等远程 MCP 客户端使用：

docker run -p 3000:3000 --rm \
  -e CAMOFOX_TRANSPORT=http \
  -e CAMOFOX_URL=http://host.docker.internal:9377 \
  ghcr.io/redf0x1/camofox-mcp:latest node dist/http.js

完整的客户端配置示例请参考 docs/getting-started.md。

快速验证

验证浏览器服务器是否可访问：

curl -fsS http://localhost:9377/health

预期响应应包含 "ok":true 和 "browserConnected":true。

✨ 主要特性

• 拥有 46 种浏览器自动化工具，涵盖导航、交互、观察、搜索、下载、会话和批量工作流等方面。
• 基于 CamoFox 浏览器服务器和 Camoufox 构建的反检测浏览器自动化。
• 支持多标签工作流，可跟踪状态、历史记录并进行清理。
• 支持会话持久化，可导入 cookie、保存配置文件，并可选择自动保存。
• 提供高效的可访问性快照，对于复杂的单页应用流程可使用 CSS 选择器作为备用方案。
• 兼容 OpenClaw 的 HTTP 传输，同时为桌面 MCP 客户端提供标准的标准输入输出支持。

📦 工具类别

| 类别 | 工具数量 | 文档 | |------|---------:|------| | 健康检查 | 1 | 健康检查 | | 标签页 | 3 | 标签页 | | 导航 | 4 | 导航 | | 交互 | 8 | 交互 | | 观察 | 8 | 观察 | | 搜索 | 1 | 搜索 | | 会话 | 4 | 会话 | | 配置文件 | 4 | 配置文件 | | 下载 | 3 | 下载 | | 提取 | 3 | 提取 | | 批量工作流 | 6 | 批量 | | 预设 | 1 | 预设 |

⚠️ 主要限制

• CamoFox MCP 不是独立的浏览器，你必须单独运行兼容的 camofox-browser 服务器。
• 可访问性树引用是主要的交互模型，但单页应用和自定义组件网站可能需要 CSS 选择器或渲染 HTML 工具。
• 如果浏览器服务器强制执行身份验证，API 密钥控制的操作需要在双方都使用相同的 CAMOFOX_API_KEY。
• HTTP 传输主要用于远程 MCP 客户端，桌面 MCP 客户端通常使用标准输入输出配置效果最佳。

🔒 安全说明

请将其视为浏览器控制界面。在共享或联网环境中，请隔离浏览器服务器，避免广泛暴露 MCP 端点，并在启用身份验证时使用 CAMOFOX_API_KEY。会话配置文件可能包含敏感的 cookie，应妥善存储。

📚 详细文档

请从 docs/README.md 开始查看文档中心，然后参考 docs/getting-started.md 进行设置、验证和首个工作流示例。

🤝 贡献与许可证

有关贡献指南，请参阅 CONTRIBUTING.md；有关 MIT 许可证，请参阅 LICENSE。