使用说明
迷彩鱼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--导航到URLbrowser_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--执行JavaScriptbrowser_run_code--在页面上下文中运行任意JSbrowser_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--列出所有Cookiebrowser_cookie_get--按名称获取cookiebrowser_cookie_set--设置cookiebrowser_cookie_delete--按名称删除cookiebrowser_cookie_clear--清除所有Cookiebrowser_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+本地存储导出为JSONbrowser_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--将页面另存为PDFbrowser_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)
许可证
麻省理工学院