Skip to content
Back to search

camoufox-reverse-mcp

🔧 反检测浏览器 MCP Server | 35 个 JS 逆向工具 + C++ 引擎层 JSVMP 指纹追踪

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/WhiteNightShadow/camoufox-reverse-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/WhiteNightShadow/camoufox-reverse-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/whitenightshadow--camoufox-reverse-mcp/badge.svg)](/listings/whitenightshadow--camoufox-reverse-mcp)

HTML

<a href="/listings/whitenightshadow--camoufox-reverse-mcp"><img src="/api/listings/whitenightshadow--camoufox-reverse-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 211 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # camoufox-reverse-mcp
  2. [![Release](https://img.shields.io/github/v/release/WhiteNightShadow/camoufox-reverse-mcp)](https://github.com/WhiteNightShadow/camoufox-reverse-mcp/releases/latest)
  3. [![CI](https://github.com/WhiteNightShadow/camoufox-reverse-mcp/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/WhiteNightShadow/camoufox-reverse-mcp/actions/workflows/ci.yml)
  4. ![Python](https://img.shields.io/badge/python-3.10%2B-blue)
  5. [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
  6. [中文](README.md) | [English](README_en.md)
  7. 基于 [Camoufox](https://github.com/daijro/camoufox) 反指纹浏览器的 MCP Server,专为 JavaScript 逆向工程设计。AI 编码助手(Claude Code、Cursor、Cline 等)可以用它分析接口参数和 JS 文件、Hook 函数、拦截网络流量、调查 JSVMP,并离线验证签名代码。
  8. [工具参考](docs/TOOLS.md) | [JSVMP 实战](docs/JSVMP_PLAYBOOK.md) | [通用采集](docs/GENERAL_COLLECTION.md) | [更新记录](CHANGELOG.md)
  9. ## 特性
  10. - **反指纹浏览器**:Camoufox 在 C++ 层修改指纹,不依赖页面 JS patch;BrowserForge 按真实流量的统计分布生成指纹。
  11. - **运行时分析**:网络捕获、脚本搜索、函数 Hook 和 JS 执行;Hook 和 JS 执行可以指定主世界和 Frame。
  12. - **JSVMP 调查**:运行时探针和源码插桩。配合[定制版浏览器](https://github.com/WhiteNightShadow/camoufox-reverse),还能在 Gecko 原生层追踪属性访问,不改写页面 JS。
  13. - **结果可验证**:用样本离线验证签名函数,定位首个偏差字符;抓到的请求可以对比和导出。
  14. ## 使用须知
  15. - 只用于自有或已获授权的目标。
  16. - MCP 客户端能读取和修改浏览器里的数据,包括 Cookie 和本地存储。不要在这个浏览器里登录不想让客户端接触的账号。
  17. - 反指纹不等于不被识别。Hook、环境差异和时序仍可能被页面观察到,具体站点能否使用要用实际样本验证。
  18. - 开启引擎追踪(`enable_trace=True`)时会临时关闭 Firefox content sandbox,普通启动不受影响。
  19. ## 环境要求
  20. - Python 3.10 及以上,支持 macOS、Linux、Windows
  21. - 支持 stdio 的 MCP 客户端;工具 schema 兼容 Moonshot/Kimi 等严格校验的服务
  22. - Camoufox 浏览器,下载量约 1.3GB,macOS 上解压后约 2.5GB
  23. ## 快速开始
  24. ### 方式一:AI 对话框直接安装(推荐)
  25. 在你的 AI 编码工具(Cursor / Claude Code / Codex 等)的对话框中输入:
  26. ```
  27. 帮我安装下这个mcp工具:camoufox-reverse-mcp
  28. 项目地址:https://github.com/WhiteNightShadow/camoufox-reverse-mcp
  29. ```
  30. AI 会自动完成克隆、安装依赖、配置 MCP Server 的全部流程。
  31. ### 方式二:手动安装
  32. 适合已有 Python 环境或需要改代码的情况。
  33. ```bash
  34. git clone https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git
  35. cd camoufox-reverse-mcp
  36. pip install -e .
  37. python -m camoufox fetch
  38. ```
  39. 最后一条下载浏览器。跳过的话,第一次 `launch_browser` 会自动下载,要等下载结束才返回,实测约 4 分钟,客户端可能先超时。
  40. 写入客户端的 MCP 配置,例如 Cursor 的 `.cursor/mcp.json`、Claude Code 项目里的 `.mcp.json`:
  41. ```json
  42. {
  43. "mcpServers": {
  44. "camoufox-reverse": {
  45. "command": "python",
  46. "args": ["-m", "camoufox_reverse_mcp"]
  47. }
  48. }
  49. }
  50. ```
  51. 这里的 `python` 要用安装时的同一个解释器。
  52. ### 方式三:uvx(无需克隆,可指定版本)
  53. 先安装 [uv](https://docs.astral.sh/uv/getting-started/installation/) 和 git,再在终端各运行一次:
  54. ```bash
  55. uvx --from "git+https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git@v1.11.1" camoufox-reverse-mcp --version
  56. uvx --from "git+https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git@v1.11.1" camoufox fetch
  57. ```
  58. 第一条下载依赖并确认版本,可以避免客户端首次启动时等待超时。第二条下载浏览器,保存在用户缓存目录,不随 uvx 环境清理。
  59. 写入客户端的 MCP 配置:
  60. ```json
  61. {
  62. "mcpServers": {
  63. "camoufox-reverse": {
  64. "command": "uvx",
  65. "args": [
  66. "--from",
  67. "git+https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git@v1.11.1",
  68. "camoufox-reverse-mcp"
  69. ]
  70. }
  71. }
  72. }
  73. ```
  74. Claude Code 也可以用一条命令添加:
  75. ```bash
  76. claude mcp add --scope user camoufox-reverse -- uvx --from "git+https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git@v1.11.1" camoufox-reverse-mcp
  77. ```
  78. <details>
  79. <summary>更新版本与常驻安装</summary>
  80. **更新版本**:在 [Releases](https://github.com/WhiteNightShadow/camoufox-reverse-mcp/releases) 查看最新标签,把配置里的 `@v1.11.1` 改成新标签,再重启客户端。标签是固定的,不改就不会变。去掉 `@v1.11.1` 会在每次启动时跟随 main 的最新提交,不建议在日常使用时这样配置。如果 `check_environment` 提示缺少浏览器,用新标签再运行一次 `camoufox fetch`。
  81. **常驻安装**:配置里的 `command` 写 `camoufox-reverse-mcp`,不需要 `args`。浏览器仍用上面的 `uvx ... camoufox fetch` 下载,两种方式共用同一份浏览器。
  82. ```bash
  83. uv tool install "git+https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git@v1.11.1"
  84. uv tool install --force "git+https://github.com/WhiteNightShadow/camoufox-reverse-mcp.git@<新标签>"
  85. ```
  86. 第二条用于更新。`uv tool upgrade` 不会移动已固定的标签,要用 `--force` 重新安装。
  87. </details>
  88. ### 验证安装
  89. 重启客户端,然后输入:
  90. ```
  91. 用 camoufox-reverse 打开 https://example.com,抓取网络请求,告诉我页面标题和请求数量
  92. ```
  93. 正常情况下客户端会启动浏览器,并返回标题 `Example Domain`。出问题时让 AI 调用 `check_environment`,它会列出依赖和浏览器的状态。
  94. ## 工具
  95. 共 42 个工具,分 10 类。参数说明和使用场景见[工具参考](docs/TOOLS.md)。
  96. | 类别 | 数量 | 用途 |
  97. |---|---:|---|
  98. | [浏览器控制](docs/TOOLS.md#浏览器控制) | 10 | 启动、导航、截图、快照、点击、输入 |
  99. | [JS 执行与调试](docs/TOOLS.md#js-执行与调试) | 2 | 在隔离上下文或页面主世界执行 JS,录制可回放的会话 |
  100. | [脚本分析](docs/TOOLS.md#脚本分析) | 2 | 列出、读取、保存脚本,搜索代码 |
  101. | [Hook 与追踪](docs/TOOLS.md#hook-与追踪) | 5 | 函数 Hook 和 Trace、预置 Hook、控制台日志 |
  102. | [网络分析](docs/TOOLS.md#网络分析) | 8 | 抓包、拦截、发起调用栈、请求对比、导出 |
  103. | [JSVMP 逆向分析](docs/TOOLS.md#jsvmp-逆向分析) | 4 | 运行时探针、源码插桩、状态级深挖、环境指纹采集与导出 |
  104. | [Firefox RDP 断点调试](docs/TOOLS.md#firefox-rdp-断点调试) | 1 | 真断点、单步、调用栈、作用域、暂停中求值、请求断点(走 Firefox 原生 RDP,不需要 CDP) |
  105. | [Cookie 与存储](docs/TOOLS.md#cookie-与存储) | 4 | Cookie、Storage、浏览器状态导入导出 |
  106. | [验证与环境](docs/TOOLS.md#验证与环境) | 3 | 离线验签、环境自检、残留清理 |
  107. | [引擎层属性追踪](docs/TOOLS.md#引擎层属性追踪) | 3 | Gecko 原生属性追踪,需要定制版浏览器 |
  108. ## 启动参数
  109. 写在启动命令后面,uvx 方式写在 `camoufox-reverse-mcp` 后面:
  110. ```json
  111. "args": ["-m", "camoufox_reverse_mcp", "--headless", "--proxy", "http://127.0.0.1:7890"]
  112. ```
  113. | 参数 | 说明 |
  114. |---|---|
  115. | `--headless` | 无头模式 |
  116. | `--proxy <url>` | 代理地址,例如 `http://127.0.0.1:7890` |
  117. | `--geoip` | 根据代理推断地理信息 |
  118. | `--humanize` | 模拟人类的鼠标移动 |
  119. | `--os <系统>` | 模拟的系统指纹:`auto`、`windows`、`macos`、`linux`,默认 `auto` |
  120. | `--locale <语言>` | 浏览器语言,例如 `zh-CN`,默认 `auto` |
  121. | `--block-images` | 不加载图片 |
  122. | `--block-webrtc` | 禁用 WebRTC |
  123. | `--version` | 输出版本后退出 |
  124. > **注意**:调用 `launch_browser` 时传了的参数优先,没传的沿用这里的启动参数。
  125. ## 文档
  126. | 文档 | 内容 |
  127. |---|---|
  128. | [工具参考](docs/TOOLS.md) | 全部工具、使用场景、技术架构 |
  129. | [JSVMP 实战](docs/JSVMP_PLAYBOOK.md) | 反爬类型识别与工作流 |
  130. | [通用采集](docs/GENERAL_COLLECTION.md) | 采集行为、限制与示例 |
  131. | [真实源码与验证](docs/REAL_SOURCE_VALIDATION.md) | 真实上游源码的实操记录 |
  132. | [公开研究与实操记录](docs/RESEARCH_AND_VALIDATION.md) | 公开方案取舍与 Agent 验证方法 |
  133. ## 更新记录
  134. - **v1.11.1**(2026-11-15):修复 Windows CI 下两条 POSIX Unix socket 路径测试未跳过的问题,并对齐自动发布流水线校验。[详情](docs/releases/v1.11.1.md)
  135. - **v1.11.0**(2026-11-15):新增 `rdp_debugger`,走 Firefox 原生 RDP 补齐真断点、单步、调用栈、作用域、暂停帧求值与请求前断点;与 `launch_browser` 共用指纹/代理/激活版本配置,支持 macOS/Linux 0700 Unix socket,工具扩充为 42 个。[详情](docs/releases/v1.11.0.md)
  136. - **v1.10.0**(2026-11-12):插桩默认只改写成员读取、文件上限提到 2MB,能离线改写本地源码,日志能按序号和状态切片;同源 iframe 的事件汇总到顶层日志;preset 改装到页面主世界;`compare_env` 能导出环境包;新增 `stage_break` 和 `trace_session`。[详情](docs/releases/v1.10.0.md)
  137. 全部版本见 [CHANGELOG.md](CHANGELOG.md)。
  138. ## 社区贡献者
  139. - [@tuntun1337](https://github.com/tuntun1337) — 严格 JSON Schema 兼容性
  140. - [@Code-xy](https://github.com/Code-xy) — Windows 引擎追踪问题定位与验证
  141. - [@Moojing-jianchuan](https://github.com/Moojing-jianchuan) — JSVMP 执行点关联需求与分析材料,`instrumentation` 的 `tap_stage_calls` 阶段插桩,`stage_break` 与 `trace_session`,`rdp_debugger` Firefox RDP 断点调试,以及 v1.10.0 处理的 #19–#25 问题报告
  142. - [@dsaw1111](https://github.com/dsaw1111) — Camoufox 152 版本差距与 PropertyTracer 升级需求
  143. - [@chung1912](https://github.com/chung1912) — `uvx` 安装建议与 `uv tool install` 配置
  144. - [@tunguyen1993](https://github.com/tunguyen1993) — `hook_jsvmp_interpreter` 的 `script_url` 转义问题与修复建议
  145. ## 反馈 / 交流
  146. 使用过程中遇到 bug、想要新的 Hook 预设、或者想交流 JS 逆向思路,欢迎加微信:
  147. - **微信号**:`han8888v8888`
  148. > 加好友时烦请备注「camoufox-reverse」,方便快速通过。
  149. ## 许可证
  150. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.