WhiteNightShadow /wx-mp-mcp
微信小程序逆向 MCP — 在线实时解包 + AI 静态分析还原接口签名/加密,产出本地 Node.js 直接能跑的脚本(零侵入,不碰微信进程)
★ 304⑂ 57👁 1⑃ 0● 2▤ 0
More from this author
+1
Daily
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) → 反推精确公式并生成复现代码(传