Camoufox Playwright MCP

공식과 동등한 수준의 Playwright Model Context Protocol (MCP) 서버에 Camoufox — 봇 방어 시스템, Cloudflare Turnstile, DataDome 및 고급 브라우저 핑거프린팅을 기본적으로 우회하도록 설계된 스텔스 및 탐지 방지 브라우저 엔진 — 을 더했습니다.

주요 특징

• 🥷 기본 스텔스: 하드웨어 스푸핑, 인간화된 커서 움직임 및 GeoIP 정렬을 갖춘 Camoufox의 맞춤형 탐지 방지 브라우저 엔진 기반.

• 🎭 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 도구

공식 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: 쿠키를 가져오고, 설정하고, 지웁니다.

• browser_network: 경로 및 네트워크 가로채기를 관리합니다.

라이선스

Apache License 2.0. 자세한 내용은 LICENSE를 참조하세요.