Camoufox Playwright MCP

Ein offiziell paritätischer Playwright Model Context Protocol (MCP)-Server, aufgeladen mit Camoufox – der Stealth- und Anti-Erkennungs-Browser-Engine, die Anti-Bot-Systeme, Cloudflare Turnstile, DataDome und erweiterte Browser-Fingerprinting sofort umgeht.

Highlights

• 🥷 Stealth by Default: Angetrieben von Camoufoxs eigener Anti-Erkennungs-Browser-Engine mit Hardware-Spoofing, humanisierten Cursor-Bewegungen und GeoIP-Abgleich.

• 🎭 100% Offizielle Playwright MCP-Parität: Vollständige Tool-Parität mit dem offiziellen TypeScript Playwright MCP (browser_navigate, browser_click, browser_fill, browser_snapshot, browser_take_screenshot, browser_evaluate, usw.).

• 🔄 Duale Engine-Flexibilität: Standardmäßig mit Stealth-camoufox ausführen oder nahtlos zu standardmäßigen Playwright-Browsern (chromium, chrome, firefox, webkit) oder benutzerdefinierten CDP-Endpunkten wechseln.

• ⚡ Null Installation via uvx: Sofort in Claude Desktop, Cursor, Cline, Windsurf oder jedem MCP-Client ausführen, ohne manuelle Einrichtung.

Related MCP server: wraith-mcp

Schnellstart

1. On-the-fly mit uvx ausführen

Keine vorherige Installation erforderlich:

# 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. Client-Konfigurationen

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "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"
      ]
    }
  }
}

Installation

Sie können camoufox-playwright-mcp auch in Ihre virtuelle Umgebung installieren:

Mit uv

uv add camoufox-playwright-mcp

Mit pip

pip install camoufox-playwright-mcp

Browser-Binärdateien installieren

Laden Sie die Camoufox-Browser-Binärdatei herunter:

camoufox-playwright-mcp install-browser

Um auch die standardmäßigen Playwright-Browser zu installieren:

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

CLI-Referenz

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] ...

Allgemeine Flags

Befehle

• camoufox-playwright-mcp install-browser: Lädt Camoufox- und/oder Playwright-Browser-Binärdateien herunter.

Camoufox Stealth- und Anti-Erkennungs-Optionen

Wenn Sie mit --browser camoufox (Standard) ausführen, wendet Camoufox erweiterte Stealth-Konfigurationen an. Sie können tiefere Konfigurationen über eine JSON-Konfigurationsdatei (--config config.json) bereitstellen:

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

Umgebungsvariablen

Alle CLI-Flags können über Umgebungsvariablen konfiguriert werden:

(Hinweis: PLAYWRIGHT_MCP_*-Variablen werden aus Gründen der Abwärtskompatibilität ebenfalls unterstützt).

Verfügbare MCP-Tools

Volle 1:1-Übereinstimmung mit den offiziellen Playwright MCP-Spezifikationen:

• browser_navigate: Zu einer angegebenen URL navigieren.

• browser_click: Auf Elemente klicken, indem Locators, Koordinaten oder Text verwendet werden.

• browser_fill: Eingabefelder mit Anti-Erkennungs-Tastaturanschlägen ausfüllen.

• browser_snapshot: Vollständige Zugänglichkeits- und semantische Baum-Snapshots erfassen.

• browser_take_screenshot: Ganzseitige oder Element-Screenshots erfassen.

• browser_evaluate: JavaScript sicher im Seitenkontext ausführen.

• browser_hover, browser_press_key, browser_type: Maus- und Tastaturinteraktionen.

• browser_tabs: Mehrere Browser-Tabs und -Fenster verwalten.

• browser_cookies: Cookies abrufen, setzen und löschen.

• browser_network: Routen und Netzwerkabfänge verwalten.

Lizenz

Apache License 2.0. Siehe LICENSE für Details.