Camoufox Playwright MCP

一个与官方功能对等的 Playwright 模型上下文协议（MCP）服务器，并搭载了 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 工具

与官方 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。