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 客戶端提供標準的標準輸入輸出支持。

📦 工具類別

⚠️ 主要限制

• 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。