wx-mp-mcp

微信小程序逆向 MCP

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

一个 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 一步就能定位签名并生成复现代码（走得出 → 直接导出）；只有签名被运行时加密 / JSVMP 混淆、静态读不出时，才走 抓包 → 破解 / 沙箱 那条支线。

1. 安装

方式一（推荐） —— 直接对你的 AI 编码工具说：

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

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

方式二 —— 手动：

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

2. 配置到客户端

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

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 签名脚本。

完成后你本地：

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

分析产物（落在 static/out/<appid>/）：可读源码树 app/、报告 report.json + REPORT.md、复现代码 repro.node.mjs + repro.python.py、独立签名脚本 signer.mjs。

使用中遇到问题、想反馈 bug、或交流逆向思路，欢迎加微信：

微信号：han8888v8888（加好友请备注「wx-mp-mcp」）

v0.1.3 — 缓存探测兼容性 + macOS 权限诊断

• 缓存目录递归自动探测：不再写死单一路径，从微信缓存锚点递归发现所有含 <appid>/<版本>/*.wxapkg 的「包根」。修复多账号 / 不同微信版本下缓存落在 .../radium/users/<账号哈希>/... 等非默认层级时 mp_list_apps 返回 0、mp_analyze 报「未找到缓存包」的问题；多账号自动合并去重。

• Windows 新版微信 4.0(xwechat) 支持：补 %APPDATA%\Tencent\xwechat\radium\Applet 路径（旧版 WeChat Files\Applet 仍兼容）；递归时跳过聊天/媒体/缓存等重目录，避免扫 xwechat_files 的大体积归档拖慢。

• macOS 权限保护可诊断：扫描遇到 TCC 容器保护（EPERM/EACCES）时不再静默吞掉，明确提示「授予完全磁盘访问权限」或「复制副本」两条解法；副本放进 wxapkg-cache/ 等位置自动发现。WXAPKG_ROOT 支持多路径（: / ;）覆盖。

• mp_decrypt 传裸 appid 可自动定位最新缓存，输出落到项目内安全目录而非受保护容器。

v0.1.2 — 沙箱通用加固(实战打磨)

• realm 自洽：沙箱不再注入外层内建，[].push === Array.prototype.push，JSVMP/字节码解释器不再崩。

• webpack 惰性取模块：覆盖全局 jsonp 与内嵌 {id:fn} 两种形态，只实例化目标模块子树、不引导 app。

• 多 bundle 协同：分包签名 SDK 依赖主包 runtime 时，bundle_paths 拼接单次载入。

• JSVMP 友好：runInContext(code, ms) 带超时执行(同步死循环可中断)、调用后清退心跳定时器；补齐 wx.getRandomValues/getLogManager、performance/atob/btoa、可配 UA。

• 网关签名检测：识别 hmac-auth / x-hmac-digest / mtgsig / wsgsig / __NS_sig 等签名协议，消除「重度签名却报无签名」假阴性。

• 解包↔沙箱路径统一 + 报错清噪(不再回吐整包源码/命令行)。

v0.1.1

• 新增 mp_capture_import：已有抓包（HAR / cURL / JSON 体 / JSONL）一键归一，自己抓的包直接喂破解，免走代理。

• analyze→crack 自动桥：mp_analyze 报告多吐 crackHint（候选密钥 + 算法 + 参数序），mp_sign_crack 传 report 直接消费，少一次人工搬运。

v0.1.0

• 11 个工具打通完整链路：实时解包 → mitmproxy 抓包 → AI 离线分析 → 导出本地 Node 黑盒脚本，经 MCP 暴露给任意 AI Agent。

• Mac + Windows 缓存目录自动探测（WXAPKG_ROOT 可手动指定）。

• 不碰微信进程：磁盘加密包离线解密（V1MMWX）+ 被动抓包 + Node vm 沙箱，无内存改写、无进程注入。

• 签名多信号判定：拦截器 / 安全 SDK / 签名头 / 响应解密联合判定，避免「误报无签名」。

⚠️ 仅用于对自有 / 已授权小程序的安全分析与接口对接。不得用于未授权访问、绕过他人系统安全机制或违反服务条款的行为。