隐身浏览器自动化工具

Camoufox-mcp是一个具备58种工具的隐身浏览器MCP服务器,用于反检测的网页自动化,支持指纹欺骗、人类化鼠标移动和自动通过Cloudflare Turnstile。

  • by esxr
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 esxr/camoufox-mcp

使用说明

迷彩鱼mcp

隐形浏览器MCP服务器,配备58个反检测网络自动化工具。直接替换 @剧作家/mcp --相同的接口,由 迷彩 (防指纹Firefox)。

快速开始

uvx --from camoufox-mcp-server camoufox-mcp

或者从源代码安装:

git clone https://github.com/esxr/camoufox-mcp.git
cd camoufox-mcp
uv venv && uv pip install -e .
python -m camoufox fetch

使用Claude代码

添加到您的 .mcp.json:

{
  "mcpServers": {
    "camoufox": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "camoufox-mcp-server", "camoufox-mcp"],
      "env": {
        "CAMOUFOX_HEADLESS": "true",
        "CAMOUFOX_HUMANIZE": "true"
      }
    }
  }
}

为什么迷彩胜过剧作家?

常规Playwright浏览器会立即被机器人检测标记。Camoufox将相同的Playwright API封装在反检测Firefox上,该Firefox:

  • 每个会话的假操作系统/浏览器指纹(画布、WebGL、音频)
  • 通过自然曲线使鼠标运动人性化
  • 自动通过Cloudflare旋转栅门
  • 支持通过GeoIP区域设置匹配的身份验证代理
  • 加载Firefox插件(uBlock Origin等)
剧作家MCP 迷彩MCP
浏览器 Chromium 反检测Firefox
指纹 可检测 每次会话都会伪造
旋转栅门/haptcha 受阻 通行证
鼠标移动 即时传送 类人曲线
代理支持 基本 身份验证+地理IP匹配
插件 否 Firefox扩展
工具数量 22(核心) 58(全套)

工具(58)

核心导航与交互(23)

  • browser_navigate --导航到URL
  • browser_navigate_back --回去吧
  • browser_snapshot --带有交互式元素引用的可访问性树
  • browser_click --按ref单击元素
  • browser_type --在元素中键入文本
  • browser_fill_form --一次填写多个表单字段
  • browser_select_option --选择下拉选项
  • browser_hover --将鼠标悬停在元素上
  • browser_drag --元素之间的拖动
  • browser_press_key --按键盘键
  • browser_take_screenshot --屏幕截图(整页、元素或视口)
  • browser_evaluate --执行JavaScript
  • browser_run_code --在页面上下文中运行任意JS
  • browser_tabs --列出、创建、关闭、切换选项卡
  • browser_console_messages --读取控制台输出
  • browser_network_requests --检查网络流量
  • browser_wait_for --等待时间/文本/元素
  • browser_file_upload --上传文件
  • browser_handle_dialog --接受/关闭对话框
  • browser_resize --调整视口大小
  • browser_close --关闭浏览器
  • browser_install --获取camofox二进制文件

存储(17)

  • browser_cookie_list --列出所有Cookie
  • browser_cookie_get --按名称获取cookie
  • browser_cookie_set --设置cookie
  • browser_cookie_delete --按名称删除cookie
  • browser_cookie_clear --清除所有Cookie
  • browser_localstorage_list --列出本地存储条目
  • browser_localstorage_get --获取本地存储值
  • browser_localstorage_set --设置本地存储值
  • browser_localstorage_delete --删除本地存储密钥
  • browser_localstorage_clear --清除所有本地存储
  • browser_sessionstorage_list --列出会话存储条目
  • browser_sessionstorage_get --获取会话存储值
  • browser_sessionstorage_set --设置会话存储值
  • browser_sessionstorage_delete --删除会话存储密钥
  • browser_sessionstorage_clear --清除所有会话存储
  • browser_storage_state --将Cookie+本地存储导出为JSON
  • browser_set_storage_state --从保存状态还原

网络拦截(3)

  • browser_route --拦截/修改与模式匹配的请求
  • browser_route_list --列出活动路线规则
  • browser_unroute --删除路由规则

视觉/坐标鼠标(6)

  • browser_mouse_move_xy --将光标移动到坐标
  • browser_mouse_click_xy --点击坐标
  • browser_mouse_drag_xy --在坐标之间拖动
  • browser_mouse_down --按下鼠标按钮
  • browser_mouse_up --松开鼠标按钮
  • browser_mouse_wheel --通过鼠标滚轮滚动

开发工具与测试(9)

  • browser_start_tracing --开始剧作家追踪
  • browser_stop_tracing --停止跟踪,保存到文件
  • browser_start_video --开始视频录制
  • browser_stop_video --停止视频,保存到文件
  • browser_pdf_save --将页面另存为PDF
  • browser_generate_locator --获取引用的Playwright定位字符串
  • browser_verify_text_visible --断言文本在页面上可见
  • browser_verify_element_visible --断言元素按角色可见
  • browser_verify_value --断言元素具有预期值

配置

所有通过环境变量:

变量 默认值 描述
CAMOUFOX_HEADLESS true 无头奔跑
CAMOUFOX_HUMANIZE true 类人鼠标动作
CAMOUFOX_PROXY -- 代理URL: http://user:pass@host:port
CAMOUFOX_GEOIP false 自动将区域设置/时区与代理IP匹配
CAMOUFOX_OS -- 假操作系统: windows, macos, linux
CAMOUFOX_LOCALE -- 浏览器区域设置(例如。 en-US)
CAMOUFOX_ADDONS -- 逗号分隔的Firefox插件路径
CAMOUFOX_WIDTH 1280 视口宽度
CAMOUFOX_HEIGHT 720 视口高度

系统要求

  • python 3.10+
  • 紫外线 (推荐)或pip
  • 迷彩浏览器二进制文件(通过自动获取 python -m camoufox fetch)

许可证

麻省理工学院