Camoufox Playwright MCP

Camoufox を搭載した、公式と同等の Playwright Model Context Protocol (MCP) サーバー。ステルス性とアンチ検出を備えたブラウザエンジンで、Cloudflare Turnstile、DataDome、高度なブラウザフィンガープリンティングなどのアンチボットシステムをそのままバイパスします。

ハイライト

• 🥷 デフォルトでステルス: ハードウェアの偽装、人間らしいカーソル動作、GeoIP の整合性を備えた Camoufox のカスタムアンチ検出ブラウザエンジンを搭載。

• 🎭 公式 Playwright MCP と完全互換: 公式 TypeScript Playwright MCP のツール（browser_navigate、browser_click、browser_fill、browser_snapshot、browser_take_screenshot、browser_evaluate など）をすべてサポート。

• 🔄 デュアルエンジンの柔軟性: デフォルトのステルス camoufox で実行するか、標準の Playwright ブラウザ（chromium、chrome、firefox、webkit）やカスタム CDP エンドポイントにシームレスに切り替え可能。

• ⚡ uvx によるインストール不要: Claude Desktop、Cursor、Cline、Windsurf、または任意の MCP クライアントで手動セットアップなしですぐに実行。

Related MCP server: wraith-mcp

クイックスタート

1. uvx でその場で実行

事前のインストールは不要です：

# Run stealth Camoufox browser in headless mode (recommended for AI agents)
uvx camoufox-playwright-mcp --headless

# Or run with standard Chrome
uvx camoufox-playwright-mcp --browser chrome

2. クライアント設定

Claude Desktop

claude_desktop_config.json にこれを追加します：

{
  "mcpServers": {
    "camoufox": {
      "command": "uvx",
      "args": [
        "camoufox-playwright-mcp",
        "--headless"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "camoufox": {
      "command": "uvx",
      "args": ["camoufox-playwright-mcp", "--headless"]
    }
  }
}

Windsurf / Cline / OpenCode / Zed

{
  "mcpServers": {
    "browser": {
      "command": "uvx",
      "args": [
        "camoufox-playwright-mcp",
        "--headless"
      ]
    }
  }
}

インストール

camoufox-playwright-mcp を仮想環境にインストールすることもできます：

uv を使用

uv add camoufox-playwright-mcp

pip を使用

pip install camoufox-playwright-mcp

ブラウザバイナリのインストール

Camoufox ブラウザバイナリを取得します：

camoufox-playwright-mcp install-browser

標準の Playwright ブラウザもインストールする場合：

camoufox-playwright-mcp install-browser chromium firefox webkit
# or install all
camoufox-playwright-mcp install-browser all

CLI リファレンス

usage: camoufox-playwright-mcp [-h] [--browser BROWSER] [--headless] [--isolated]
                               [--user-data-dir USER_DATA_DIR] [--proxy-server PROXY_SERVER]
                               [--cdp-endpoint CDP_ENDPOINT] [--port PORT] ...

共通フラグ

コマンド

• camoufox-playwright-mcp install-browser: Camoufox または Playwright ブラウザバイナリをダウンロードします。

Camoufox ステルス & アンチ検出オプション

--browser camoufox（デフォルト）で実行すると、Camoufox は高度なステルス設定を適用します。JSON 設定ファイル（--config config.json）を使用して、より詳細な設定を提供できます：

{
  "browser": {
    "provider": "camoufox",
    "camoufoxOptions": {
      "geoip": true,
      "humanize": true,
      "os": "windows",
      "block_images": false
    }
  }
}

環境変数

すべての CLI フラグは環境変数を介して設定できます：

（注：後方互換性のために PLAYWRIGHT_MCP_* 変数もサポートされています。）

利用可能な MCP ツール

公式 Playwright MCP 仕様と完全な 1:1 互換性があります：

• browser_navigate: 指定された URL に移動します。

• browser_click: ロケーター、座標、またはテキストを使用して要素をクリックします。

• browser_fill: アンチ検出キーストロークを使用して入力フィールドに値を入力します。

• browser_snapshot: 完全なアクセシビリティとセマンティックツリーのスナップショットを取得します。

• browser_take_screenshot: ページ全体または要素のスクリーンショットを取得します。

• browser_evaluate: ページコンテキスト内で JavaScript を安全に評価します。

• browser_hover、browser_press_key、browser_type: マウスとキーボードの操作。

• browser_tabs: 複数のブラウザタブとウィンドウを管理します。

• browser_cookies: Cookie の取得、設定、クリアを行います。

• browser_network: ルートとネットワークインターセプトを管理します。

ライセンス

Apache ライセンス 2.0。詳細については LICENSE を参照してください。