Skip to content
Back to search

JSReverser-MCP

JSReverser-MCP 是一个面向 JavaScript 逆向分析的 MCP 工具,专门用于帮助开发者在真实浏览器环境中高效定位前端核心逻辑。它 将脚本检索、断点调试、函数 Hook、网络请求追踪、调用链分析、混淆还原和风险评估整合为统一能力,可直接接入 Claude、 Codex、Cursor 等支持 MCP 的客户端。你可以连接已开启的 Chrome,在登录态页面下持续采样请求参数与返回数据,快速定位签名、 加密、鉴权和关键业务流程。工具同时支持自动化页面操作与结构化报告导出,适合用于接口分析、安全研究、前端调试与工程排障等 场景

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/noone-hub--jsreverser-mcp/badge.svg)](/listings/noone-hub--jsreverser-mcp)

HTML

<a href="/listings/noone-hub--jsreverser-mcp"><img src="/api/listings/noone-hub--jsreverser-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 · 507 lines

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

  1. # JS Reverse MCP
  2. [English README](README.en.md)
  3. 一个把前端 JavaScript 逆向流程标准化的 MCP 服务。
  4. 目标不是只做页面调试,而是把页面观察、运行时采样、本地复现、补环境和证据沉淀串成一套可复用工作流。
  5. ## 核心方法论
  6. 本项目默认遵循以下方法论:
  7. - `Observe-first`
  8. - `Hook-preferred`
  9. - `Breakpoint-last`
  10. - `Rebuild-oriented`
  11. - `Evidence-first`
  12. - `Pure-extraction-after-pass`
  13. 这意味着:
  14. 1. 先在浏览器里确认请求、脚本、函数和依赖来源
  15. 2. 再做最小化 Hook 采样
  16. 3. 再导出 local rebuild
  17. 4. 再在 Node 里逐项补环境
  18. 5. 每一步都沉淀为 task artifact,而不是只留在对话里
  19. ## 已沉淀链路
  20. 以下参数链路已有公开索引,可作为仓库内复用入口:
  21. - 某东 `h5st` 参数
  22. - 索引:[scripts/cases/README.md](scripts/cases/README.md)
  23. - Case:[scripts/cases/jd-h5st-pure-node.mjs](scripts/cases/jd-h5st-pure-node.mjs)
  24. - 某手 `falcon` 风控参数
  25. - 索引:[scripts/cases/README.md](scripts/cases/README.md)
  26. - Case:[scripts/cases/ks-hxfalcon-pure-node.mjs](scripts/cases/ks-hxfalcon-pure-node.mjs)
  27. - 某音 `a-bogus` 参数
  28. - 索引:[scripts/cases/README.md](scripts/cases/README.md)
  29. - Case:[scripts/cases/douyin-a-bogus-pure-node.mjs](scripts/cases/douyin-a-bogus-pure-node.mjs)
  30. 说明:
  31. - README 首页只展示脱敏后的参数类型和公开入口
  32. - 真实 `artifacts/tasks/<task-id>/` 默认视为本地私有任务目录
  33. - Git 默认只提交 `artifacts/tasks/_TEMPLATE/`
  34. ### 参数蓝图库
  35. 公开参数方法已沉淀到 [docs/knowledge/parameter-blueprints/](docs/knowledge/parameter-blueprints/),用于替代旧的可运行 case 入口。查看和贡献方式:
  36. ```bash
  37. node build/src/index.js --list-parameter-workflows
  38. node build/src/index.js --show-parameter-workflow jd-h5st
  39. node build/src/index.js --export-parameter-workflow-template
  40. node build/src/index.js --validate-parameter-workflow docs/knowledge/parameter-blueprints/jd-h5st
  41. ```
  42. 贡献规范见 [docs/guides/parameter-workflow-contribution.md](docs/guides/parameter-workflow-contribution.md)。
  43. ## 支持的能力
  44. ### 页面观察与脚本定位
  45. 先回答“页面里有哪些脚本、目标代码大概在哪”。
  46. - `list_scripts`:列出当前页面已加载的脚本,先建立脚本范围。
  47. - `get_script_source`:查看指定脚本源码,适合继续阅读具体实现。
  48. - `find_in_script`:在单个脚本里定位字符串、变量名或特征片段。
  49. - `search_in_scripts`:在已采集脚本缓存中批量搜索,适合缩小候选脚本范围。
  50. ### Hook 与运行时采样
  51. 先做最小侵入式观测,确认运行时到底调用了什么。
  52. - `create_hook`:创建可复用的 hook 定义,用于后续注入页面。
  53. - `inject_hook`:把已有 hook 注入当前页面,开始采样目标行为。
  54. - `get_hook_data`:读取 hook 采集到的调用记录和摘要结果。
  55. - `hook_function`:直接 hook 全局函数或对象方法,记录参数和返回值。
  56. - `trace_function`:按源码函数名做调用追踪,适合跟调用链。
  57. ### 断点与调试控制
  58. 当 hook 不够时,再进入暂停式调试。
  59. - `set_breakpoint`:按脚本 URL 和行号设置断点。
  60. - `set_breakpoint_on_text`:按代码文本自动定位并设置断点。
  61. - `resume`:继续执行到下一个断点或执行结束。
  62. - `pause`:手动暂停当前页面的 JavaScript 执行。
  63. - `step_over` / `step_into` / `step_out`:单步控制执行路径,分别对应跳过、进入、跳出函数。
  64. ### 请求链路与网络分析
  65. 定位目标请求,确认是谁发起、带了什么参数。
  66. - `list_network_requests`:列出当前页面的网络请求,先找到目标请求。
  67. - `get_network_request`:查看单个请求的详细内容,包括请求头、响应和载荷。
  68. - `get_request_initiator`:追溯某个请求是谁触发的,帮助定位调用链。
  69. - `break_on_xhr`:在目标请求发出时中断,适合抓参数生成前的现场。
  70. ### 页面状态与运行前检查
  71. 补看页面运行状态、控制台输出和本地状态依赖。
  72. - `check_browser_health`:检查浏览器连接和当前页是否可控,适合作为起手验证。
  73. - `diagnose_environment`:输出 Node、浏览器、路径和依赖状态,适合第一次启动建议和故障排查。
  74. - `recommend_next_step`:根据当前证据推荐下一步动作。
  75. - `explain_reverse_stage`:解释当前逆向阶段、输入要求和退出条件。
  76. - `list_console_messages`:查看当前页面 console 输出,适合回看 hook 和 trace 日志。
  77. - `get_storage`:读取 cookie、`localStorage`、`sessionStorage`,确认状态依赖。
  78. - `evaluate_script`:在当前选中 frame 内执行一段函数,做小范围运行时验证。
  79. - `search_in_sources`:在所有已加载源码中搜索关键字,快速缩小可疑代码范围。
  80. ### WebSocket 观察与消息分组
  81. 处理长连接、直播流或二进制帧时,用这组工具先分流再细看。
  82. - `list_websocket_connections`:列出当前页面的 WebSocket 连接,先拿到目标 `wsid`。
  83. - `analyze_websocket_messages`:按帧特征做消息分组,适合先识别不同消息类型。
  84. - `get_websocket_messages`:查看某个连接或某个分组下的消息摘要和内容。
  85. ### 本地复现与补环境
  86. 把页面证据带回本地,逐步补齐 Node 运行环境。
  87. - `export_rebuild_bundle`:导出本地复现工程所需的入口、补环境和证据材料。
  88. - `diff_env_requirements`:根据报错和观测能力比对当前缺失的环境能力。
  89. - `record_reverse_evidence`:把关键观察结果写入 task artifact,避免证据只留在对话里。
  90. ### 页面自动化
  91. 做最小必要的页面操作,复现触发条件并辅助取证。
  92. - `navigate_page`:跳转、回退、刷新当前页面。
  93. - `query_dom`:查询页面元素,确认选择器和节点状态。
  94. - `click_element`:按选择器触发点击,复现页面动作。
  95. - `hover_element` / `select_option`:处理菜单悬停和原生下拉框选择。
  96. - `type_text`:向输入框写入文本,驱动表单交互。
  97. - `press_key` / `upload_file`:补齐键盘提交和文件上传场景。
  98. - `scroll_page` / `wait_for_network_idle`:稳定触发懒加载和请求结束后的取证。
  99. - `set_viewport` / `emulate_device`:复现移动端或特定视口下的签名链路。
  100. - `get_all_links`:快速盘点页面链接,辅助发现跳转入口。
  101. - `take_screenshot`:截取页面当前状态,保留可视化证据。
  102. ### 深度分析
  103. 在拿到代码和运行时证据后,继续做结构理解与去混淆。
  104. - `collect_code`:采集页面代码,支持按优先级或范围控制采样量。
  105. - `understand_code`:结合静态分析和 AI 做代码结构、业务逻辑与风险理解。
  106. - `deobfuscate_code`:对混淆代码做清理、还原和辅助分析。
  107. - `risk_panel`:聚合代码分析、加密检测和 hook 信号,输出综合风险视图。
  108. ### 会话与登录态复用
  109. - `save_session_state`:保存当前页面的 cookie 和存储状态到内存快照。
  110. - `restore_session_state`:把快照恢复到当前页面,复用登录态和现场。
  111. - `dump_session_state`:把会话快照导出为 JSON 文件,便于持久化。
  112. - `load_session_state`:从已有 JSON 或字符串重新载入会话快照。
  113. ### 逆向任务编排与 Agent 消费
  114. - `start_reverse_task` / `create_reverse_task_from_request`:从目标、请求或页面证据创建 task artifact,供后续 summarize / progress / orchestration 复用。
  115. - `manage_reverse_task`:默认入口就是 `manage_reverse_task`,支持 `get / summarize` 以及 `archive / restore / search / tag / prune / compare`。
  116. - `orchestrate_reverse_task`:按阶段推进观察、采样、重建、验证和提纯,输出 `recommendedStrategy`、`agentGuidance`、`fallbackPlan` 和 `skipSteps`。
  117. - `run_reverse_agent`:提供面向 agent 的一站式任务运行入口。
  118. - `query_reverse_task`:读取 compact 摘要、下一步建议、`outputMode`、`artifacts`、`patchSuggestions`、`evidenceAggregates` 和可续跑 payload。
  119. - `get_rebuild_health_report`:汇总 local rebuild 健康状态,辅助 env-fix。
  120. - `export_rebuild_bundle` 支持 portable bundle / replay bundle 导出,便于把 `env-pass` 结果交给后续纯算法提取。
  121. CLI cheatsheet:
  122. ```bash
  123. node build/src/index.js --doctor
  124. node build/src/index.js --manageReverseTask list
  125. node build/src/index.js --manageReverseTask get --taskId <taskId>
  126. node build/src/index.js --manageReverseTask summarize --taskId <taskId>
  127. node build/src/index.js --manageReverseTask progress --taskId <taskId>
  128. node build/src/index.js --manageReverseTask search --query sign --tag jd
  129. node build/src/index.js --manageReverseTask compare --taskId <taskId> --otherTaskId <otherTaskId>
  130. node build/src/index.js --orchestrateReverseTask <taskId>
  131. node build/src/index.js --orchestrateReverseTask <taskId> --execute --resume
  132. node build/src/index.js --orchestrateReverseTask <taskId> --strategy env-fix
  133. node build/src/index.js --orchestrateReverseTask <taskId> --executionOverrides '{"resume":true}'
  134. node build/src/index.js --runReverseAgent <taskId>
  135. ```
  136. 更多细节见:
  137. - [docs/guides/reverse-task-orchestration.md](docs/guides/reverse-task-orchestration.md)
  138. - [docs/guides/mcp-agent-quick-reference.md](docs/guides/mcp-agent-quick-reference.md)
  139. - [docs/guides/mcp-client-auto-resume-example.md](docs/guides/mcp-client-auto-resume-example.md)
  140. - [docs/reference/reverse-agent-response.schema.json](docs/reference/reverse-agent-response.schema.json)
  141. - [docs/reference/reverse-agent-schema-versioning.md](docs/reference/reverse-agent-schema-versioning.md)
  142. 完整参数说明见 [docs/reference/tool-reference.md](docs/reference/tool-reference.md)。
  143. 按逆向流程选工具可继续看 [docs/reference/reverse-workflow.md](docs/reference/reverse-workflow.md)。
  144. ### 外部 AI 怎么配置
  145. 这个项目支持把外部 LLM 作为“分析增强层”接进来,当前支持:
  146. - `openai`
  147. - `anthropic`
  148. - `gemini`
  149. 配置入口本质上是进程环境变量。
  150. 通过 MCP 客户端启动时,优先在 MCP server 配置里的 `env` 传入;`.env` 只适合你直接本地运行 `node build/src/index.js` 或 `npm run start` 的场景。
  151. 推荐方式示例:
  152. ```toml
  153. [mcp_servers.js-reverse]
  154. command = "node"
  155. args = ["/ABSOLUTE/PATH/JSReverser-MCP/build/src/index.js"]
  156. [mcp_servers.js-reverse.env]
  157. DEFAULT_LLM_PROVIDER = "anthropic"
  158. ANTHROPIC_API_KEY = "your_key"
  159. ANTHROPIC_MODEL = "claude-3-5-sonnet-20241022"
  160. ```
  161. 如果你是直接在项目目录本地启动,也可以使用 `.env`:
  162. ```bash
  163. # 三选一:openai / anthropic / gemini
  164. DEFAULT_LLM_PROVIDER=gemini
  165. # OpenAI
  166. OPENAI_API_KEY=your_key
  167. OPENAI_MODEL=gpt-4o
  168. OPENAI_BASE_URL=
  169. # Anthropic / Claude
  170. ANTHROPIC_API_KEY=your_key
  171. ANTHROPIC_MODEL=claude-3-5-sonnet-20241022
  172. ANTHROPIC_BASE_URL=
  173. # Gemini
  174. GEMINI_API_KEY=your_key
  175. GEMINI_MODEL=gemini-2.0-flash-exp
  176. # 如果不用 API,也可以走本地 CLI
  177. GEMINI_CLI_PATH=gemini-cli
  178. ```
  179. 说明:
  180. - `DEFAULT_LLM_PROVIDER` 决定默认走哪个 provider
  181. - `gemini` 支持两种模式:有 `GEMINI_API_KEY` 时走 API;没有时会尝试走 `GEMINI_CLI_PATH`
  182. - `openai` 和 `anthropic` 需要对应 API key
  183. - 如果你配了多个 provider,实际使用哪个,仍由 `DEFAULT_LLM_PROVIDER` 决定
  184. ### 哪些功能依赖外部 AI
  185. 强依赖外部 AI 的功能:
  186. - `understand_code`
  187. - 内部会调用 LLM 做代码语义理解、业务逻辑提取、安全风险补充
  188. 可选启用外部 AI 的功能:
  189. - `detect_crypto`
  190. - 只有传 `useAI=true` 时才会额外调用 LLM;不传时主要依赖本地规则和 AST 分析
  191. - `analyze_target`
  192. - 传 `useAI=true` 时会在一站式分析里启用更深的 AI 辅助分析
  193. - `risk_panel`
  194. - 参数里有 `useAI`,但当前实现主体仍以本地分析结果聚合为主
  195. 有 AI 时效果更好,但不配也能运行的功能:
  196. - `deobfuscate_code`
  197. - 本地规则、AST 优化、专项反混淆管线始终可用;配置外部 AI 后,复杂语义清理、VM 结构理解、部分编码型混淆降级分析会更完整
  198. 完全不依赖外部 AI 的功能:
  199. - 浏览器接管
  200. - Hook / 断点 / Console / Storage / Network / WebSocket
  201. - `collect_code`
  202. - `export_rebuild_bundle`
  203. - `diff_env_requirements`
  204. - `record_reverse_evidence`
  205. 如果没配外部 AI,典型影响是:
  206. - `understand_code` 会先返回本地静态分析结果,并在 `aiRuntime` 里提示 provider / CLI fallback 状态
  207. - `detect_crypto(useAI=true)` 会退回本地分析或忽略 AI 增强
  208. - `deobfuscate_code` 仍可跑,但某些高难度混淆的解释和清理质量会下降
  209. ## 标准任务结构
  210. 任务目录统一使用:
  211. - `artifacts/tasks/_TEMPLATE/`
  212. - `artifacts/tasks/<task-id>/`
  213. 推荐目录结构:
  214. - `task.json`
  215. - `runtime-evidence.jsonl`
  216. - `network.jsonl`
  217. - `scripts.jsonl`
  218. - `env/env.js`
  219. - `env/polyfills.js`
  220. - `env/entry.js`
  221. - `env/capture.json`
  222. - `run/`
  223. - `report.md`
  224. 职责边界:
  225. - `env.js`
  226. - 基础宿主对象和最小 shim
  227. - `polyfills.js`
  228. - 代理诊断层、`watch`、`safeFunction`、`makeFunction`
  229. - `entry.js`
  230. - 运行入口、目标脚本加载、first divergence 输出
  231. ## 标准执行流程
  232. 推荐流程:
  233. 1. 页面观察
  234. 2. 运行时采样
  235. 3. 证据入库
  236. 4. local rebuild
  237. 5. 逐项补环境
  238. 6. first divergence 定位
  239. 7. `env-pass` 后再进入纯算法 / 风控逻辑提纯
  240. 默认原则:
  241. - 不要跳过页面证据直接猜环境
  242. - 不要一次性全量模拟浏览器
  243. - 不要把真实任务目录直接提交 Git
  244. ## 参数沉淀与安全边界
  245. 参数链路沉淀遵循以下规则:
  246. 1. 先读本地 task artifact
  247. - `artifacts/tasks/<task-id>/`
  248. 2. 本地没有时再读抽象 case
  249. - `scripts/cases/*`
  250. 3. 仍不足时按模板新建
  251. - `docs/reference/parameter-methodology-template.md`
  252. - `docs/reference/parameter-site-mapping-template.md`
  253. 安全边界:
  254. - case 只保留抽象方法和流程
  255. - 真实任务目录默认本地保留
  256. - 敏感值必须脱敏后才允许共享
  257. - Git 默认只提交 `_TEMPLATE`
  258. 详见:
  259. - [docs/reference/case-safety-policy.md](docs/reference/case-safety-policy.md)
  260. - [docs/reference/reverse-artifacts.md](docs/reference/reverse-artifacts.md)
  261. - [docs/reference/env-patching.md](docs/reference/env-patching.md)
  262. ## 第一次启动建议
  263. 先运行 `npm ci` 和 `npm run build`,再用 `node build/src/index.js --doctor` 检查本地 Node、浏览器连接、路径和外部 AI 配置。
  264. ## 工具暴露模式
  265. 默认启动使用 `--toolProfile kernel`。
  266. 该模式只暴露 35 个自动化优先工具,用来减少 MCP tool list 占用的 token,同时保留任务编排、请求追踪、代码定位、诊断和产物导出入口。
  267. 这不是缺工具,而是默认把低频手工调试工具隐藏起来。
  268. 需要更宽的常用工作流工具时,使用 `--toolProfile compact`。
  269. `compact` 会暴露 63 个高频工具,适合需要手动页面操作、Hook、截图和环境微调的场景。
  270. 需要全量工具时,使用 `--toolProfile full`。
  271. `full` 会暴露全部 110 个工具,包括暂停、单步、断点、WebSocket 细节和 DOM 细调工具。
  272. 深度人工调试、精确断点排查、WebSocket 消息深挖时再切换到 `full`。
  273. ```bash
  274. node build/src/index.js --toolProfile full
  275. ```
  276. 成功响应默认使用 `--traceOutput errors`,只在错误响应中携带 `traceId`。
  277. 需要每次成功响应也携带 `traceId` 时,使用 `--traceOutput all`。
  278. ## 3 分钟快速开始
  279. ### 1) 安装依赖并构建
  280. ```bash
  281. npm ci
  282. npm run build
  283. ```
  284. 构建入口:
  285. ```bash
  286. build/src/index.js
  287. ```
  288. ### 2) 最简单启动方式
  289. ```bash
  290. npm run start
  291. ```
  292. ### 3) 配置客户端
  293. 最小配置示例:
  294. #### Claude Code
  295. ```bash
  296. claude mcp add js-reverse node /ABSOLUTE/PATH/JSReverser-MCP/build/src/index.js
  297. ```
  298. #### Cursor
  299. - Command: `node`
  300. - Args: `[/ABSOLUTE/PATH/JSReverser-MCP/build/src/index.js]`
  301. #### Codex
  302. ```toml
  303. [mcp_servers.js-reverse]
  304. command = "node"
  305. args = ["/ABSOLUTE/PATH/JSReverser-MCP/build/src/index.js"]
  306. ```
  307. 如果你需要接管已经打开的浏览器,请继续看:
  308. - [docs/guides/browser-connection.md](docs/guides/browser-connection.md)
  309. - [docs/guides/client-configuration.md](docs/guides/client-configuration.md)
  310. 完整可直接复制的 MCP 配置实例,包括:
  311. - `mcpServers` JSON 结构示例
  312. - Codex `config.toml` 示例
  313. - `--browserUrl` 接管浏览器示例
  314. - Gemini / Claude / OpenAI 的 API `env` 示例
  315. 都放在 [docs/guides/client-configuration.md](docs/guides/client-configuration.md)。
  316. ## 文档入口
  317. 逆向相关任务开场先读:`docs/reference/reverse-bootstrap.md`。
  318. 该入口会继续要求模型读取 `docs/reference/case-safety-policy.md`、`docs/reference/reverse-workflow.md`。
  319. 若已进入 `env-pass` 后的提纯阶段,再读 `docs/reference/pure-extraction.md`。
  320. ### Guides
  321. - 快速开始:[docs/guides/getting-started.md](docs/guides/getting-started.md)
  322. - 浏览器连接:[docs/guides/browser-connection.md](docs/guides/browser-connection.md)
  323. - 客户端配置:[docs/guides/client-configuration.md](docs/guides/client-configuration.md)
  324. - 逆向工作流:[docs/reference/reverse-workflow.md](docs/reference/reverse-workflow.md)
  325. - 补环境规范:[docs/reference/env-patching.md](docs/reference/env-patching.md)
  326. ### Reference
  327. - 模型首读入口:[docs/reference/reverse-bootstrap.md](docs/reference/reverse-bootstrap.md)
  328. - 逆向任务索引:[docs/reference/reverse-task-index.md](docs/reference/reverse-task-index.md)
  329. - 工具参数总表:[docs/reference/tool-reference.md](docs/reference/tool-reference.md)
  330. - 工具读写契约:[docs/reference/tool-io-contract.md](docs/reference/tool-io-contract.md)
  331. - 任务产物说明:[docs/reference/reverse-artifacts.md](docs/reference/reverse-artifacts.md)
  332. ### Templates And Supporting Docs
  333. - [docs/reference/reverse-update-prompt-template.md](docs/reference/reverse-update-prompt-template.md)
  334. - [docs/reference/reverse-report-template.md](docs/reference/reverse-report-template.md)
  335. - [docs/reference/algorithm-upgrade-template.md](docs/reference/algorithm-upgrade-template.md)
  336. - [docs/reference/parameter-methodology-template.md](docs/reference/parameter-methodology-template.md)
  337. - [docs/reference/parameter-site-mapping-template.md](docs/reference/parameter-site-mapping-template.md)
  338. ## 开发与测试
  339. ```bash
  340. npm run build
  341. npm run test:unit
  342. npm run test:property
  343. npm run coverage:full
  344. ```
  345. ## 故障排查
  346. 更多问题排查请看:
  347. - [docs/guides/browser-connection.md](docs/guides/browser-connection.md)
  348. - [docs/guides/client-configuration.md](docs/guides/client-configuration.md)
  349. - [docs/guides/troubleshooting.md](docs/guides/troubleshooting.md)
  350. ## 参考项目
  351. 本项目在设计和实现过程中参考了以下项目,具体协议声明(如 MIT 等)以对应上游仓库为准:
  352. - https://github.com/wuji66dde/jshook-skill
  353. - https://github.com/zhizhuodemao/js-reverse-mcp
  354. - https://github.com/ChromeDevTools/chrome-devtools-mcp
  355. ## License
  356. Apache-2.0

Ratings and comments

Sign in to rate this skill.

Sign in

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