camoufox-reverse-mcp
基于反指纹浏览器的 MCP Server,专为 JavaScript 逆向工程设计。
一个 MCP(Model Context Protocol)服务器,让 AI 编码助手(Claude Code、Cursor、Cline 等)能够通过 Camoufox 反指纹浏览器对目标网站进行:接口参数分析、JS 文件静态分析、动态断点调试、函数 Hook 追踪、网络流量拦截、JSVMP 字节码分析、Cookie/存储管理等逆向操作。
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
基于反指纹浏览器的 MCP Server,专为 JavaScript 逆向工程设计。
一个 MCP(Model Context Protocol)服务器,让 AI 编码助手(Claude Code、Cursor、Cline 等)能够通过 Camoufox 反指纹浏览器对目标网站进行:接口参数分析、JS 文件静态分析、动态断点调试、函数 Hook 追踪、网络流量拦截、JSVMP 字节码分析、Cookie/存储管理等逆向操作。
🔧 反检测浏览器 MCP Server | 35 个 JS 逆向工具 + C++ 引擎层 JSVMP 指纹追踪
核心优势:
Object.defineProperty 防覆盖保护;锁定属性可能需要重建 Context 才能恢复evaluate_js(result_format="json_ascii");低副作用函数日志可选 hook_function(serialization="preview"),同步异常有明确记录。compare_network_requests、save_response_body,保留原始请求语义并明确哈希/字节口径。list_network_requests(limit=100, after_id=0) 增量读取;export_network_capture 导出有版本号的 JSON,默认掩码,保留旧调用方式。verify_signer_offline(..., runtime="node") 可不启动浏览器验证独立签名函数;默认 browser 路径不变,无有效期望值的样本不会再误通过。详细行为、限制与示例见 通用采集契约 和 v1.6.0 版本说明。
在你的 AI 编码工具(Cursor / Claude Code / Codex 等)的对话框中输入:
帮我安装下这个mcp工具:camoufox-reverse-mcp
项目地址:https://github.com/WhiteNightShadow/camoufox-reverse-mcp
AI 会自动完成克隆、安装依赖、配置 MCP Server 的全部流程。
git clone https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git
cd camoufox-reverse-mcp
pip install -e .
v1.1.0 将 MCP Python SDK 固定在兼容的 v1 系列,并自动规范化可选参数 schema,可兼容 Moonshot/Kimi 等要求每个工具参数都包含
type的严格服务。
{
"mcpServers": {
"camoufox-reverse": {
"command": "python",
"args": ["-m", "camoufox_reverse_mcp"]
}
}
}
{
"mcpServers": {
"camoufox-reverse": {
"command": "python",
"args": ["-m", "camoufox_reverse_mcp", "--headless"]
}
}
}
{
"mcpServers": {
"camoufox-reverse": {
"command": "python",
"args": [
"-m", "camoufox_reverse_mcp",
"--proxy", "http://127.0.0.1:7890",
"--geoip",
"--humanize"
]
}
}
}
反爬类型 → 工具路径对照表
需要对齐浏览器与沙箱中的同一执行点时,可在安装时设置
include_source_site=True。事件会增加稳定 site_id 与单调 seq,log
返回 source_sites sidecar,映射到拦截脚本的原始字符区间。该能力默认关闭;
它表示混淆后 JS 的源码位置,不会猜测 VM 的 PC、opcode 或保护前源码位置。
对超过 200KB 且需要全量改写的脚本,需显式设置 on_oversized="force";
否则应配合属性过滤并按需关闭 rewrite_calls 控制开销。
需要 camoufox-reverse 定制版浏览器。未安装时返回错误提示,不影响其他工具使用。
从 v1.3.0 起,Camoufox Python 0.5+ 用户可让官方版和定制版并存,且不改变 持久化 active 版本:
check_environment()
launch_browser(
browser_version="whitenightshadow/152.0.4-beta.30-reverse.5",
enable_trace=True
)
browser_version 必须使用 repo/版本或精确目录,存在同版本多份资产时必须传
精确目录。省略该参数时启动行为与 v1.2.0 完全相同;Camoufox 0.4.x 用户继续
使用原来的平铺缓存。所选版本必须与 active 浏览器具有相同完整 version/build,避免
上游共享资源产生版本混用。MCP 不下载浏览器、不修改 config.json,也不会触发缓存迁移。
每次 enable_trace=True 启动都会使用独立 run 目录,只控制本次浏览器的
PID,不会清理或开关其他 MCP 实例。开启 engine trace 时会临时关闭 Firefox
content sandbox 以允许内容进程写入;普通启动不会改动 sandbox。
1. launch_browser()
2. inject_hook_preset("xhr")
3. inject_hook_preset("crypto")
4. navigate("https://example.com/login")
5. type_text("#username", "test") → click("#login-btn")
6. list_network_requests(method="POST")
7. get_request_initiator(request_id=3) ← 定位签名函数
8. search_code("sign") ← 搜索签名代码
9. hook_function("window.getSign", mode="trace", world="main", persistent=True)
10. reload() → get_trace_data("window.getSign", world="main") ← 收集追踪数据
1. launch_browser()
2. network_capture(action="start")
3. navigate("https://target-site.com/")
4. list_network_requests(resource_type="script") ← 找到 VMP 脚本
5. instrumentation(action="install", url_pattern="**/vmp_target*.js", mode="ast")
6. inject_hook_preset("cookie", persistent=True)
7. instrumentation(action="reload") ← 让插桩生效
8. instrumentation(action="log", type_filter="tap_get") ← 看 VMP 读了什么环境
9. instrumentation(action="log", type_filter="tap_method") ← 看 VMP 调了什么 API
10. compare_env() ← 收集环境用于 Node.js 补齐
1. launch_browser() → navigate("https://target.com")
2. network_capture(action="start")
3. # 触发目标操作,收集带签名的请求
4. reqs = list_network_requests(url_filter="api/search")
5. # 提取样本
6. verify_signer_offline(
signer_code="(s) => ({'X-Bogus': mySign(s.url)})",
samples=[{"id": "r1", "input": {...}, "expected": {"X-Bogus": "..."}}]
)
👉 完整的反爬类型识别与工作流见 docs/JSVMP_PLAYBOOK.md
1. launch_browser(
browser_version="whitenightshadow/152.0.4-beta.30-reverse.5",
enable_trace=True
) ← 显式启动定制版
2. trace_property_access(action="start") ← 清空旧窗口并立即返回
3. navigate("https://www.douyin.com/video/xxx") ← 在新窗口内触发 JSVMP
4. # 继续执行 click/evaluate 等目标操作
5. trace_property_access(action="stop", mode="summary", collect_values=True)
→ 返回覆盖范围内命中的属性、频次、get/set/call、进程与 native site
→ snapshot_values 是操作后的安全快照;Cookie、Canvas、WebGL、Audio 等
敏感或有副作用的路径会进入 values_skipped
# 按时间线查看属性访问节奏
6. trace_property_access(action="query", mode="timeline", bucket_ms=500)
# 按对象过滤
7. trace_property_access(action="query", filter_object="webgl")
# 搜索特定属性
8. trace_property_access(action="query", mode="search", search_query="cookie")
与 compare_env 的区别:
trace_property_access:对当前构建声明的固定 Gecko 原生注入点提供强证据;
reverse.5 为 77 点,未命中不能证明
覆盖范围外的属性未被读取,也可能有高负载时间侧信道compare_env:采集一组 JS 层环境基线;可通过 properties 或分批
evaluate_js 扩展,不能视为全量枚举compare_env 与动态验证确认完整范围,避免把覆盖集之外的未命中误作否定证据┌─────────────────────────────────────────────────┐
│ AI 编码助手 (Cursor / Claude) │
│ ↕ MCP (stdio) │
├─────────────────────────────────────────────────┤
│ camoufox-reverse-mcp │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │Navigation│ Script │Debugging │ Hooking │ │
│ │ │ Analysis │ │ │ │
│ ├──────────┼──────────┼──────────┼──────────┤ │
│ │ Network │ JSVMP │ Cookie │ Verify │ │
│ │ Capture │ Analysis │ Storage │ Signer │ │
│ ├──────────┴──────────┴──────────┴──────────┤ │
│ │ ★ PropertyTracer (trace_property_access) │ │
│ │ Gecko 原生固定点追踪(不改写页面 JS) │ │
│ └───────────────────────────────────────────┘ │
│ ↕ Playwright API │
├─────────────────────────────────────────────────┤
│ Camoufox (反指纹 Firefox, Juggler 协议) │
│ C++ 引擎级指纹伪造 · BrowserForge 真实指纹分布 │
└─────────────────────────────────────────────────┘
wrappedJSObject 回退,继续避免失败后重复执行pending 状态evaluate_js/hook_function 新增显式 world="main",默认隔离上下文保持不变;Camoufox 原生 mw: 优先,旧版可安全回退frame_url/frame_name/frame_index,多匹配和不稳定持久索引明确拒绝pending/target_not_found,不再假报成功get_trace_data,Trace 缓存按 world/Frame 隔离且有界;修复 intercept 忽略 persistent 的问题camoufox-reverse reverse.5,将既有 localStorage.getItem/setItem
两点迁移到 Firefox 152 默认 LSNG LSObject 路径hook_count 改为明确未知camoufox-reverse reverse.4:75 个原路径不变,正确区分 get/set/call,并解析 native site、进程序列和微秒时间扩展字段trace_property_access 新增兼容的 action=start/stop/query/capture/clear/status;可在 start 后继续执行页面操作,再 stop 聚合installed/trace_active;check_environment 现在拆分 installed、trace_capable、trace_activecollect_values 明确为追踪后的安全快照;Cookie 与可能产生副作用的 API 默认跳过enable_trace=True 时,不再注入无效配置或关闭 sandbox;普通启动保持不变enable_trace=False 不受影响launch_browser 新增可选 browser_version,单次选择 Camoufox 0.5+ 已安装版本且不修改 active 配置check_environment 新增 Camoufox Python、active、installed selectors、能力标记及旧缓存迁移风险诊断C.UTF-8 时生成无效 locale="C"、导致浏览器无法启动的问题instrumentation(action="install") 新增默认关闭的 include_source_sitesite_id 和单调 seqinstrumentation(action="log") 返回原始脚本 SHA-256、URL、字符区间与 AST 行列 sidecar,并补齐 hot_functionsCAMOU_CONFIG_1..n 后,enable_trace=True 无法注入 propertyTrace、持续返回 engine_trace_not_available 的问题camoufox.utils.get_env_vars() 模拟 Windows 分块增加回归测试camoufox-reverse 用户只需升级 MCP,无需重新编译或替换浏览器new X().m1().m2()、Array.prototype.slice.call(arguments) 等嵌套调用因父子 AST 编辑区间重叠而生成损坏代码的问题instrumentation(action="status") 新增 last_mode_used,可区分 AST、regex 回退和超大文件跳过路径稳定版:新增引擎层属性追踪和已运行浏览器接管,并提升严格 JSON Schema 服务及跨平台运行的兼容性。
新增工具
trace_property_access — Gecko 原生 DOM/Web API 定点追踪,不改写页面 JS 对象;支持 summary/timeline/sequence/search 四种视图list_trace_files — 列出本地 trace 文件query_trace_file — 查询历史 trace 文件变更
launch_browser 新增 enable_trace 参数,启用后自动注入 CAMOU_CONFIG 和 MOZ_DISABLE_CONTENT_SANDBOXlaunch_browser 新增 ws_endpoint,可接管已运行的 Camoufox 浏览器check_environment 新增 camoufox_reverse 字段,检测定制版浏览器安装状态稳定性修复
pageError 崩溃Content-Encoding 导致的内容丢失依赖
MCP Python SDK 固定为 mcp>=1.29,<2;v2 迁移将在后续版本单独进行
需要 camoufox-reverse 定制版浏览器(可选,不装不影响其他工具)
重大版本:80 → 32 工具,schema tokens 减半。移除 Session 档案/断言系统,回归纯 JS 逆向工具定位。
工具合并(v0.9.0)
network_capture(action=start/stop/clear/status) ← start/stop_network_capturescripts(action=list/get/save) ← list_scripts / get_script_source / save_scriptsearch_code(keyword, script_url=None) ← search_code / search_code_in_scripthook_function(path, mode=intercept/trace) ← hook_function / trace_functioninstrumentation(action=install/log/stop/reload/status) ← instrument_jsvmp_source / get_instrumentation_log / stop_instrumentation / reload_with_hooks / get_instrumentation_statuscookies(action=get/set/delete) ← get_cookies / set_cookies / delete_cookies移除的工具
新增
verify_signer_offline — 无状态签名函数验证(替代 verify_against_session)Bug 修复(v0.8.1)
evaluate_js:多策略 JSON 解析(控制字符清理、双重编码解包)navigate:默认清理网络缓存,防止跨导航请求污染get_network_request:max_body_size 参数控制 body 截断(默认 5000)launch_browser:already_running 时返回残留状态诊断移除的依赖:tldextract(仅 Session 使用)
设计理念:MCP 是纯工具集(stateless),不做工作流管理。分析项目的记忆/累积属于 skill 层和用户工作区。
hook_jsvmp_interpreter(mode="proxy"):修复 Proxy 递归导致 too much recursionremove_hooks:真正恢复 Proxy 对象evaluate_js:BOM / lone surrogate / whitespace 自动清理instrument_jsvmp_source:CSP 预检navigate:超时优雅降级instrument_jsvmp_source 默认 MCP 侧 AST 改写hook_jsvmp_interpreter 新增 mode="transparent"使用过程中遇到 bug、想要新的 Hook 预设、或者想交流 JS 逆向思路,欢迎加微信:
han8888v8888加好友时烦请备注「camoufox-reverse」,方便快速通过。
MIT
🔧 反检测浏览器 MCP Server | 35 个 JS 逆向工具 + C++ 引擎层 JSVMP 指纹追踪
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Camoufox Reverse roda localmente via stdio.
Última verificação: 2026-10-28. 🔧 反检测浏览器 MCP Server | 35 个 JS 逆向工具 + C++ 引擎层 JSVMP 指纹追踪