camoufox-reverse-mcp
基于反指纹浏览器的 MCP Server,专为 JavaScript 逆向工程设计。
一个 MCP(Model Context Protocol)服务器,让 AI 编码助手(Claude Code、Cursor、Cline 等)能够通过 Camoufox 反指纹浏览器对目标网站进行:接口参数分析、JS 文件静态分析、动态断点调试、函数 Hook 追踪、网络流量拦截、JSVMP 字节码分析、Cookie/存储管理等逆向操作。
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
基于反指纹浏览器的 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 指纹追踪
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Camoufox Reverse 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 🔧 反检测浏览器 MCP Server | 35 个 JS 逆向工具 + C++ 引擎层 JSVMP 指纹追踪