Camoufox Playwright MCP

Сервер MCP (Model Context Protocol) Playwright с полной совместимостью, усиленный Camoufox — скрытным антидетект-движком, предназначенным для обхода антибот-систем, Cloudflare Turnstile, DataDome и продвинутой браузерной идентификации «из коробки».

Ключевые особенности

• 🥷 Скрытность по умолчанию: Работает на основе кастомного антидетект-движка Camoufox с подменой аппаратного обеспечения, имитацией человеческих движений курсора и привязкой к GeoIP.

• 🎭 100% совместимость с официальным 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-инструменты

Полное соответствие 1:1 со спецификациями официального Playwright MCP:

• 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: Получение, установка и очистка куки.

• browser_network: Управление маршрутами и перехват сетевых запросов.

Лицензия

Лицензия Apache 2.0. См. LICENSE для подробностей.