Camofox MCP

🚀 CamoFox MCP

AIによる検知回避機能が備わった、MCP互換のAIエージェント用のブラウザオートメーションツールです。

CamoFox MCPは、Claude Desktop、VS Code、Cursor、OpenClawなどのMCPクライアントをCamoFoxブラウザサーバーに接続します。これにより、エージェントはナビゲーション、インタラクション、検索、抽出、ダウンロード、セッション再利用などの実用的なブラウザツールセットを利用でき、その下ではCamoFoxベースの検知回避動作を利用します。

✨ 主な機能

• ナビゲーション、インタラクション、観測、検索、ダウンロード、セッション、バッチワークフローなど、46のブラウザオートメーションツールが用意されています。
• CamoFoxブラウザサーバーとCamoFoxをベースに構築された検知回避型ブラウザオートメーションです。
• 状態、履歴の追跡とクリーンアップ機能を備えたマルチタブワークフローが可能です。
• クッキーのインポート、保存されたプロファイル、オプションの自動保存機能によるセッションの永続化ができます。
• 難しいSPAフローに対応するため、CSSセレクターのフォールバック機能を備えたトークン効率の良いアクセシビリティスナップショットが利用できます。
• OpenClaw互換のHTTPトランスポートと、デスクトップMCPクライアント用の標準的なstdioサポートがあります。

📦 インストール

両方のコンポーネントを実行する必要があります。

1. camofox-browser は検知回避型ブラウザを扱います。
2. camofox-mcp はそのブラウザをMCPクライアントに公開します。

オプションA: npx + stdio

ブラウザサーバーを起動します。

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

OpenClawなどのリモートMCPクライアント用に、HTTPモードでCamoFox 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 が含まれます。

🛠 ツールカテゴリ

⚠️ 主な制限事項

• CamoFox MCPはスタンドアロンのブラウザではありません。互換性のある camofox-browser サーバーを別途実行する必要があります。
• アクセシビリティツリー参照は主要なインタラクションモデルですが、SPAやカスタムコンポーネントのサイトではCSSセレクターまたはレンダリングされたHTMLツールが必要になる場合があります。
• ブラウザサーバーが認証を強制する場合、APIキーで制限された操作には両側で同じ CAMOFOX_API_KEY が必要です。
• HTTPトランスポートは主にリモートMCPクライアント用です。デスクトップMCPクライアントは通常、stdio構成で最適に動作します。

🔒 セキュリティ

これはブラウザコントロールサーフェイスとして扱ってください。共有またはネットワーク環境では、ブラウザサーバーを分離し、MCPエンドポイントを広く公開しないようにし、認証が有効になっている場合は CAMOFOX_API_KEY を使用してください。セッションプロファイルには機密性の高いクッキーが含まれる可能性があるため、適切に保管してください。

📚 ドキュメント

ドキュメントのハブは docs/README.md から始め、docs/getting-started.md を使用してセットアップ、検証、最初のワークフローの例を確認できます。

🤝 コントリビューションとライセンス

コントリビューションガイドラインは CONTRIBUTING.md を、MITライセンスについては LICENSE を参照してください。