WhiteNightShadow /wx-mp-mcp

微信小程序逆向 MCP — 在线实时解包 + AI 静态分析还原接口签名/加密,产出本地 Node.js 直接能跑的脚本(零侵入,不碰微信进程)

★ 304⑂ 57👁 1⑃ 0● 2▤ 0
JavaScriptApache-2.0Created 2026-06-29
+1
日增长
304
stars
57
forks
1
watchers
0
prs
2
issues
0
releases

README

wx-mp-mcp

微信小程序逆向 MCP

把小程序接口的签名 / 加密参数,还原成一个本地 Node.js 就能直接跑的脚本



!MCP
!Node
!WeChat
!Platform
!NonInvasive



 一个 MCP(Model Context Protocol)Server,装进你的 AI 编码工具(Claude Code / Cursor / Codex),让 AI 自动完成微信小程序的解包 → 抓包 → 签名分析 → 本地复现。

---

 三个核心能力







实时解包

Mac + Windows

直接读磁盘上的加密包(.wxapkg)离线解密成可读 js 源码,主包 / 分包 / 插件全解。微信开不开都行。






数据抓包

mitmproxy 拦截

HTTPS 代理拦下小程序真实请求,自动存成结构化样本——每条带 url、参数、sign 签名字段。






AI 离线分析

还原本地 Node 黑盒

AI 读 js 定位签名算法 → 穷举反推 / 沙箱实跑复现 → 导出脱离微信的独立签名脚本。





 🛡️ 不碰微信进程:全程只做「读磁盘加密包 · 走代理被动抓流量 · Node 跑解包出的代码副本」三件事,不 attach 微信、不改内存、不开调试端口——不会让微信环境异常或触发风控。(传统 Frida / WMPFDebugger 要注入微信进程改内存,有封号风险,本工具刻意避开。)

---

 工作流



解包分析mp_analyze
→
抓真实样本mp_capture_
→
破解 / 沙箱mp_sign_crack
→
导出mp_sandbox_export
→
本地出 signnode signer.mjs



多数无混淆小程序,mp_analyze 一步就能定位签名并生成复现代码(走得出 → 直接导出);只有签名被运行时加密 / JSVMP 混淆、静态读不出时,才走 抓包 → 破解 / 沙箱 那条支线。

---

 快速接入

 1. 安装

方式一(推荐) —— 直接对你的 AI 编码工具说:


帮我安装下这个 mcp 工具:wx-mp-mcp
项目地址:https://github.com/WhiteNightShadow/wx-mp-mcp


AI 会自动克隆、装依赖、构建、写好 MCP 配置。

方式二 —— 手动:

bash
git clone https://github.com/WhiteNightShadow/wx-mp-mcp.git
cd wx-mp-mcp && npm install && npm run build


 2. 配置到客户端


Cursor(.cursor/mcp.json)

json
{
  "mcpServers": {
    "wx-mp-mcp": {
      "command": "node",
      "args": ["/绝对路径/wx-mp-mcp/dist/index.js"]
    }
  }
}





Claude Code

bash
claude mcp add wx-mp-mcp -- node /绝对路径/wx-mp-mcp/dist/index.js




 抓包额外准备:抓包属于可选能力,需在本机安装 mitmproxy(pip install mitmproxy 或 brew install mitmproxy)。代理接入与证书配置由用户根据自己的采集环境完成;其余工具无额外外部依赖。

 ⚠️ macOS 提示「容器目录受权限保护」/ 找不到缓存 / 解包阻塞:微信缓存在沙盒容器里,受 macOS TCC 保护。MCP 是被你的 AI 工具拉起的 node 子进程,继承上层程序的权限。若报「受保护」「找不到缓存」,二选一:
 - 推荐:系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加运行 MCP 的程序(Terminal / iTerm / Cursor / Claude)→ 完全退出再重开。
 - 兜底:用访达把 .../radium/Applet/packages 复制到项目下的 wxapkg-cache/(或 ~/Desktop/wxapkg-cache),会被自动发现;也可复制到任意目录后设 WXAPKG_ROOT 指向它。

 多账号 / 不同微信版本下缓存可能落在 .../radium/users//... 等层级,现已自动递归探测并合并,无需手配。

 Windows:新版微信 4.0(xwechat) 的小程序包在 %APPDATA%\Tencent\xwechat\radium\Applet,旧版 3.x 在 Documents\WeChat Files\Applet,两者均自动探测。注意 Documents\xwechat_files\ 是聊天文件存储、通常不含 wxapkg。

 3. 上手示例

把目标告诉 AI,它会自动走上面的工作流:

 分析小程序 wxXXXXXXXXXXXXXXXX 的接口 POST https://api.xxx.com/order/create,定位其 sign 签名算法,导出一个本地可独立运行的 Node 签名脚本。

完成后你本地:

bash
node signer.mjs '{"ts":"1719000000","orderId":"123"}'
 → 输出 sign,脱离微信直接复现接口请求


---

 工具清单(12)

| 工具 | 作用 |
|------|------|
|  解包分析 | |
| mp_list_apps | 列出本机微信缓存的所有小程序(appid / 版本 / 包数量) |
| mp_decrypt | 解密提取单个 .wxapkg(传 appid 自动找最新,或传文件路径) |
| mp_analyze | 一键分析:解密解包(主包+分包+插件) → 签名/加密定位 → API 抽取 → 复现代码生成 → 报告(含 crackHint:候选密钥+算法+参数序) |
| mp_analyze_all | 批量分析本机全部缓存小程序 |
|  抓包 | |
| mp_capture_start | 启动 mitmproxy 代理抓包,请求自动存成结构化 JSONL(默认 :8080,可按 URL 过滤) |
| mp_capture_list | 查看抓到的请求,自动标出 sign / token 等签名字段 |
| mp_capture_stop | 停止抓包,返回文件路径与请求数 |
| mp_capture_import | 导入已有抓包 → 归一成 JSONL(HAR / cURL / JSON 体 / JSONL,自己抓的包直接用,免走代理) |
|  签名破解 | |
| mp_sign_crack | 签名穷举:抓包样本 → 枚举参数子集 × 算法(HMAC/MD5/SHA/AES/DES/3DES) → 反推精确公式并生成复现代码(传 

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON