whitenightshadow/wx-mp-mcp

Developer tools

101 stars 0 forks 品質 90 トレンド 90

Repository Install

一个 MCP（Model Context Protocol）Server，装进你的 AI 编码工具（Claude Code / Cursor / Codex），让 AI 自动完成微信小程序的**。

概要

一个 MCP（Model Context Protocol）Server，装进你的 AI 编码工具（Claude Code / Cursor / Codex），让 AI 自动完成微信小程序的**。

README

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

三个核心能力

🛡️ 不碰微信进程：全程只做「读磁盘加密包 · 走代理被动抓流量 · 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. 配置到客户端

抓包额外准备：抓包属于可选能力，需在本机安装 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，脱离微信直接复现接口请求

工具清单（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) → 反推精确公式并生成复现代码（传 `report` 直接吃 `mp_analyze` 的候选密钥+算法，免手动搬运）
离线沙箱
`mp_sandbox_modules`	列出 bundle 里的所有模块，定位 SDK 签名模块位置
`mp_sandbox_run`	在离线 Node 沙箱加载 `app-service.js`，执行任意 js（直调签名函数验证）
`mp_sandbox_export`	导出独立签名脚本：追踪依赖、提取最小模块子集，生成不依赖 sandbox / bundle 的自包含 `.mjs`

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

问题反馈 / 联系

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

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

迭代记录

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

缓存目录递归自动探测：不再写死单一路径，从微信缓存锚点递归发现所有含 //*.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 / 签名头 / 响应解密联合判定，避免「误报无签名」。

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

View this README on GitHub

インストール

This server does not publish a one-line install command.

Open the repository installation guide

設定

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