Camoufox Playwright MCP

Un servidor del Protocolo de Contexto de Modelo (MCP) de Playwright con paridad oficial, potenciado con Camoufox — el motor de navegador sigiloso y antidetector diseñado para evadir sistemas antibot, Cloudflare Turnstile, DataDome y la huella digital avanzada del navegador de serie.

Destacados

• 🥷 Sigilo por defecto: Impulsado por el motor de navegador antidetector personalizado de Camoufox, con suplantación de hardware, movimientos de cursor humanizados y alineación GeoIP.

• 🎭 100% paridad oficial con el MCP de Playwright: Paridad total de herramientas con el MCP oficial de TypeScript de Playwright (browser_navigate, browser_click, browser_fill, browser_snapshot, browser_take_screenshot, browser_evaluate, etc.).

• 🔄 Flexibilidad de motor dual: Ejecute con el modo sigiloso camoufox por defecto, o cambie sin problemas a navegadores Playwright estándar (chromium, chrome, firefox, webkit) o endpoints CDP personalizados.

• ⚡ Instalación cero con uvx: Ejecute al instante en Claude Desktop, Cursor, Cline, Windsurf o cualquier cliente MCP sin configuración manual.

Related MCP server: wraith-mcp

Inicio rápido

1. Ejecutar al vuelo con uvx

No se necesita instalación previa:

# 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. Configuraciones de cliente

Claude Desktop

Añada esto a su 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"
      ]
    }
  }
}

Instalación

También puede instalar camoufox-playwright-mcp en su entorno virtual:

Usando uv

uv add camoufox-playwright-mcp

Usando pip

pip install camoufox-playwright-mcp

Instalación de los binarios del navegador

Descargue el binario del navegador Camoufox:

camoufox-playwright-mcp install-browser

Para instalar también los navegadores Playwright estándar:

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

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

Opciones comunes

Comandos

• camoufox-playwright-mcp install-browser: Descarga los binarios del navegador Camoufox y/o Playwright.

Opciones de sigilo y antidetector de Camoufox

Cuando se ejecuta con --browser camoufox (predeterminado), Camoufox aplica configuraciones avanzadas de sigilo. Puede proporcionar configuraciones más detalladas mediante un archivo de configuración JSON (--config config.json):

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

Variables de entorno

Todas las opciones de CLI pueden configurarse mediante variables de entorno:

(Nota: las variables PLAYWRIGHT_MCP_* también son compatibles para la compatibilidad hacia atrás).

Herramientas MCP disponibles

Coincidencia total 1:1 con las especificaciones oficiales del MCP de Playwright:

• browser_navigate: Navegar a una URL especificada.

• browser_click: Hacer clic en elementos mediante localizadores, coordenadas o texto.

• browser_fill: Rellenar campos de entrada con pulsaciones antidetectoras.

• browser_snapshot: Capturar instantáneas completas del árbol de accesibilidad y semántico.

• browser_take_screenshot: Tomar capturas de pantalla de la página completa o de elementos.

• browser_evaluate: Evaluar JavaScript de forma segura dentro del contexto de la página.

• browser_hover, browser_press_key, browser_type: Interacciones de ratón y teclado.

• browser_tabs: Gestionar múltiples pestañas y ventanas del navegador.

• browser_cookies: Obtener, establecer y eliminar cookies.

• browser_network: Gestionar rutas e interceptación de red.

Licencia

Apache License 2.0. Consulte LICENSE para más detalles.