基于反指纹浏览器的 MCP Server，专为 JavaScript 逆向工程设计。
一个 MCP（Model Context Protocol）服务器，让 AI 编码助手（Claude Code、Cursor、Cline 等）能够通过 Camoufox 反指纹浏览器对目标网站进行：接口参数分析、JS 文件静态分析、动态断点调试、函数 Hook 追踪、网络流量拦截、JSVMP 字节码分析、Cookie/存储管理等逆向操作。
| 能力 | 实现与边界 |
|---|---|
| 浏览器 | Firefox / Camoufox |
| 运行时分析 | 显式执行世界、Frame、Hook 与网络捕获 |
| JSVMP 调查 | 运行时探针与源码插桩，按具体目标验证 |
| 持久 Hook | Context 初始化，明确 pending 与卸载边界 |
核心优势：
- Camoufox 在 C++ 层面 修改指纹信息，不依赖页面 JS patch，避免常见的 descriptor/prototype 泄露
- Juggler 隔离减少部分页面侧自动化痕迹；Hook、环境差异与时序仍可能被观察
- BrowserForge 按 真实世界流量统计分布 生成指纹，不是随机拼凑
- 可用于反爬与环境依赖分析；具体站点的可用性必须通过实际样本验证
- Hook 可选
Object.defineProperty防覆盖保护；锁定属性可能需要重建 Context 才能恢复
- 真实 KProtect VM、javascript-obfuscator CFF、CryptoJS/FingerprintJS 多轮本地实操；失败反馈进入修复与复验。
- 插桩保留异常、this 和求值顺序，主世界/Frame 日志可读；本地 Acorn 支持现代语法，保守跳过不安全改写。
- 精确字符串可选
evaluate_js(result_format="json_ascii")；低副作用函数日志可选hook_function(serialization="preview")，同步异常有明确记录。 - 动态脚本按当前响应处理，不因改写失败重放请求；原生快照明确当前页面与世界。
- 新增
compare_network_requests、save_response_body，保留原始请求语义并明确哈希/字节口径。 - 环境检查按任务范围提示复用与失效，不默认清理已有证据；导航保留原始失败，快照有界等待与输出。
- 三轮九个独立任务保留失败并反馈修正，最终一轮签名/WASM/分页全部通过独立验收。
- 同 URL 并发响应按 Request 对象关联，完整采集 Cookie/Set-Cookie，并明确失败、淘汰、未完成任务和截断状态。
list_network_requests(limit=100, after_id=0)增量读取；export_network_capture导出有版本号的 JSON，默认掩码，保留旧调用方式。verify_signer_offline(..., runtime="node")可不启动浏览器验证独立签名函数；默认 browser 路径不变，无有效期望值的样本不会再误通过。- Cookie 组合过滤只删除同时匹配的条目，老运行库通过逐条过期兼容；导出不会覆盖旧文件，采集清理不会复用旧请求 ID。
详细行为、限制与示例见 通用采集契约 和 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的严格服务。
Cursor（.cursor/mcp.json）
{
"mcpServers": {
"camoufox-reverse": {
"command": "python",
"args": ["-m", "camoufox_reverse_mcp"]
}
}
}Claude Code
{
"mcpServers": {
"camoufox-reverse": {
"command": "python",
"args": ["-m", "camoufox_reverse_mcp", "--headless"]
}
}
}Claude Code（带代理）
{
"mcpServers": {
"camoufox-reverse": {
"command": "python",
"args": [
"-m", "camoufox_reverse_mcp",
"--proxy", "http://127.0.0.1:7890",
"--geoip",
"--humanize"
]
}
}
}| 工具 | 说明 |
|---|---|
launch_browser |
启动 Camoufox；可用 browser_version 单次选择已安装版本，不修改 active 配置 |
close_browser |
关闭浏览器，释放资源 |
navigate |
导航到指定 URL（支持 pre_inject_hooks、redirect_chain 追踪） |
reload |
刷新页面 |
take_screenshot |
截图（支持全页面、指定元素） |
take_snapshot |
获取页面无障碍树（token 高效） |
click / type_text |
点击元素 / 输入文本 |
wait_for |
等待元素出现或 URL 匹配 |
get_page_info |
获取当前页面 URL、标题、视口尺寸和 Frame 清单 |
| 工具 | 说明 |
|---|---|
evaluate_js |
执行 JS 表达式；默认隔离上下文，可显式选择主世界和目标 Frame |
| 工具 | 说明 |
|---|---|
scripts(action) |
脚本管理：list 列出 / get 获取源码 / save 保存到本地 |
search_code |
搜索关键词（script_url=None 全量搜索，指定 URL 则单脚本搜索，自动检测压缩文件用字符级上下文） |
| 工具 | 说明 |
|---|---|
hook_function |
Hook 或追踪函数；支持主世界、Frame、持久化和动态目标等待 |
get_trace_data |
读取/清理函数 Trace，按 world 与 Frame 过滤 |
inject_hook_preset |
一键注入预置 Hook（xhr / fetch / crypto / websocket / debugger_bypass / cookie / runtime_probe） |
remove_hooks |
移除所有 Hook 并恢复原始对象 |
get_console_logs |
获取页面 console 输出 |
| 工具 | 说明 |
|---|---|
network_capture(action) |
网络捕获控制：start / stop / clear / status |
list_network_requests |
列出已捕获的请求（支持 URL / 域名 / 方法 / 类型 / 状态码过滤） |
get_network_request |
获取请求完整详情（max_body_size 控制 body 截断） |
get_request_initiator |
获取请求发起的 JS 调用栈 |
intercept_request |
拦截请求：log / block / modify / mock / stop |
反爬类型 → 工具路径对照表
反爬类型 代表 ✅ 推荐路径 ❌ 禁用 签名型（环境即签名） RS 5/6、AK sensor_data instrumentation(action="install")pre_inject_hooks、hook_jsvmp_interpreter(mode="proxy")行为型（参数签名） TK JSVMP、JY gt4 hook_jsvmp_interpreter(mode="proxy")— 纯混淆 常见 JS 混淆工具 任意组合 —
| 工具 | 说明 |
|---|---|
hook_jsvmp_interpreter |
JSVMP 运行时探针（mode="proxy" 全覆盖 / mode="transparent" 签名安全） |
instrumentation(action) |
源码级插桩：install 注册改写 / log 获取日志 / stop 停止 / reload 重载 / status 查看状态 |
compare_env |
浏览器环境指纹收集，用于与 Node.js/jsdom 对比 |
需要对齐浏览器与沙箱中的同一执行点时，可在安装时设置
include_source_site=True。事件会增加稳定 site_id 与单调 seq，log
返回 source_sites sidecar，映射到拦截脚本的原始字符区间。该能力默认关闭；
它表示混淆后 JS 的源码位置，不会猜测 VM 的 PC、opcode 或保护前源码位置。
对超过 200KB 且需要全量改写的脚本，需显式设置 on_oversized="force"；
否则应配合属性过滤并按需关闭 rewrite_calls 控制开销。
| 工具 | 说明 |
|---|---|
cookies(action) |
Cookie 管理：get / set / delete |
get_storage |
获取 localStorage / sessionStorage |
export_state / import_state |
导出 / 导入完整浏览器状态 |
| 工具 | 说明 |
|---|---|
verify_signer_offline |
离线验证签名函数：传入样本列表，逐样本字符级对比，定位首偏差点 |
check_environment |
一站式自检：MCP、依赖、Camoufox Python/active/已安装版本及定制版状态 |
reset_browser_state |
清理残留（hooks / capture / routes / 当前 engine trace），不关浏览器 |
需要 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，也不会触发缓存迁移。
| 工具 | 说明 |
|---|---|
trace_property_access |
Gecko 原生 DOM/Web API 定点追踪；reverse.5 声明 77 点，旧兼容构建为 75 点，不改写页面 JS 对象/描述符/原型。支持 action=capture/start/stop/query/clear/status、summary/timeline/sequence/search、get/set/call、对象与 native site 过滤。collect_values=True 仅做追踪后的安全快照并列出跳过项，不代表事件发生时的值 |
list_trace_files |
跨独立 run 目录列出 trace 文件（用于事后分析） |
query_trace_file |
查询 trace 缓存内的历史文件，支持对象、关键词、kind 与 site 过滤 |
每次 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扩展，不能视为全量枚举- 路径 B 环境伪装时，用 trace 命中确定优先调查/补齐对象，再结合
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 真实指纹分布 │
└─────────────────────────────────────────────────┘
- 使用与真实调用相同的 Promise 形式探测主世界通道，识别只能返回同步结果的旧构建
- 不支持时在执行用户代码前选择
wrappedJSObject回退，继续避免失败后重复执行
- 修复清空 Trace 后再次调用目标函数抛错，保留页面原函数的返回行为
- 主世界通道先做无副作用探测，执行失败后不再通过另一通道重复运行用户代码
- 持久 Hook 可预先注册尚未创建的目标 Frame，返回明确的
pending状态 - 补齐当前 Frame 各执行世界的 Hook 卸载；不可恢复的锁定属性明确报告，无需重编浏览器
evaluate_js/hook_function新增显式world="main"，默认隔离上下文保持不变；Camoufox 原生mw:优先，旧版可安全回退- 增加 Frame 清单与
frame_url/frame_name/frame_index，多匹配和不稳定持久索引明确拒绝 - 持久 Hook 增加有界等待和通用赋值监听，可捕获动态函数首次调用；缺失目标返回
pending/target_not_found，不再假报成功 - 恢复
get_trace_data，Trace 缓存按 world/Frame 隔离且有界；修复 intercept 忽略persistent的问题 - Firefox 135、官方 152、reverse.5 及真实 FeiLin 页面验证通过，无需重新编译浏览器
- 配套
camoufox-reversereverse.5，将既有localStorage.getItem/setItem两点迁移到 Firefox 152 默认 LSNGLSObject路径 - PropertyTracer 扩为 77 点、protocol 1 不变，事件 object/property/kind 与 MCP 聚合行为不变；LSObject 与 partitioned 路径由 native site 区分
- 实时事件解析与聚合无需行为改动；默认 Trace-off、135/reverse.3/reverse.4
兼容路径不变。历史 JSONL 无构建 marker，查询时
hook_count改为明确未知
- 配套正式版
camoufox-reversereverse.4：75 个原路径不变，正确区分 get/set/call，并解析 native site、进程序列和微秒时间扩展字段 trace_property_access新增兼容的action=start/stop/query/capture/clear/status；可在 start 后继续执行页面操作，再 stop 聚合- 每次浏览器启动分配独立 trace run，控制、清理和历史查询不再影响并发 MCP 实例
- 修复无浏览器时旧 control 文件被误报为
installed/trace_active；check_environment现在拆分 installed、trace_capable、trace_active - 新窗口严格执行 off → drain → cleanup → on，避免 Windows 开放文件混入旧事件
- 新增 kind/site 过滤、跨进程确定性排序、cap 提示及 capability 协商
collect_values明确为追踪后的安全快照；Cookie 与可能产生副作用的 API 默认跳过- 可由 Camoufox 0.5 元数据识别的官方浏览器请求
enable_trace=True时，不再注入无效配置或关闭 sandbox；普通启动保持不变 - Camoufox 0.4 的官方 135 与早期无 marker 的定制 135 无法在启动前区分；为兼容旧定制版，显式请求 Trace 时仍尝试旧握手，默认
enable_trace=False不受影响
launch_browser新增可选browser_version，单次选择 Camoufox 0.5+ 已安装版本且不修改 active 配置- 选择器强制使用 repo 限定并拒绝歧义；active/selected version+build 不一致时明确拒绝
check_environment新增 Camoufox Python、active、installed selectors、能力标记及旧缓存迁移风险诊断- 修复主机为
C.UTF-8时生成无效locale="C"、导致浏览器无法启动的问题 - 默认参数保持不变；Camoufox 0.4.x + Firefox 135 用户无需迁移，官方浏览器仍可使用全部非 PropertyTracer 工具
- 配套可选的 Camoufox Reverse 152 beta.30 预发布构建
- 感谢 @dsaw1111 报告定制版与官方版本差距
instrumentation(action="install")新增默认关闭的include_source_site- AST 与 regex 插桩事件可携带内容寻址的稳定
site_id和单调seq instrumentation(action="log")返回原始脚本 SHA-256、URL、字符区间与 AST 行列 sidecar，并补齐hot_functions- 默认 tap 事件字段保持不变；不执行用户提供的任意 AST 脚本，也不把单个 VM 的变量名猜成通用 PC/opcode
- 感谢 @Moojing-jianchuan 提出执行点关联需求并提供分析材料
- 修复 Windows 上 Camoufox 将配置拆为
CAMOU_CONFIG_1..n后，enable_trace=True无法注入propertyTrace、持续返回engine_trace_not_available的问题 - 完整重组原始 JSON 后再合并追踪配置，并按平台限制重新生成任意数量的连续分块；同时清理旧分块，保留全部原始指纹配置
- 对数字顺序、十块以上配置、Unicode、分块扩缩容、无效配置及调用真实
camoufox.utils.get_env_vars()模拟 Windows 分块增加回归测试 - 针对本问题，已安装支持属性追踪的
camoufox-reverse用户只需升级 MCP，无需重新编译或替换浏览器 - 感谢 @Code-xy 报告问题、完成 Windows 实机定位并提供修复思路
- 修复
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字段，检测定制版浏览器安装状态- 自动规范化顶层可选参数 schema，兼容 Moonshot/Kimi 等严格校验服务（感谢 @tuntun1337 的贡献）
稳定性修复
- 修复 Windows 环境下 Camoufox/Playwright 导入死锁
- 修复 Playwright Firefox driver 的
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
移除的工具
- Session 档案系统（7 个）：start/stop_reverse_session、list_sessions、get_session_snapshot、attach_domain_readonly、export/import_session
- 断言系统（4 个）：add/verify/list/remove_assertion
- 冷工具（37 个）：trace_property_access、freeze_prototype、find_dispatch_loops、get_page_content、bypass_debugger_trap、check_detection、get_fingerprint_info、dump_jsvmp_strings、evaluate_js_handle、add_init_script、set_breakpoint_via_hook、get_breakpoint_data 等
新增
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"- 反爬类型决策表 + JSVMP Playbook
- 源码级插桩、Cookie 归因、运行时探针
- hook_jsvmp_interpreter 多路径覆盖重写
- @tuntun1337 — 严格 JSON Schema 兼容性
- @Code-xy — Windows 引擎追踪问题定位与验证
- @Moojing-jianchuan — JSVMP 执行点关联需求与分析材料
- @dsaw1111 — Camoufox 152 版本差距与 PropertyTracer 升级需求
使用过程中遇到 bug、想要新的 Hook 预设、或者想交流 JS 逆向思路，欢迎加微信：
- 微信号：
han8888v8888
加好友时烦请备注「camoufox-reverse」，方便快速通过。
MIT
