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 → 抓真实样本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 配置。

方式二 —— 手动：

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

2. 配置到客户端

Cursor（.cursor/mcp.json）

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

Claude Code

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

抓包额外准备：本机装 mitmproxy（pip install mitmproxy 或 brew install mitmproxy），手机 WiFi 代理指向「本机 IP : 8080」并安装其 CA 证书。其余工具零外部依赖、开箱即用。

⚠️ 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.m