MCP-WEDECODEMCP

基于 wedecode 项目改造的微信小程序反编译 MCP Server，重点面向 Cherry Studio 等 MCP 客户端的本机扫描、反编译和结构分析流程。

这个仓库保留了 wedecode 的核心反编译能力，并在此基础上补了一层适合 MCP 场景的封装，主要目标是让模型能够安全地：

• 扫描本机微信和企业微信缓存中的小程序包
• 由用户选择目标小程序后再执行反编译
• 安全读取反编译结果中的文件
• 在 Cherry Studio 中走稳定的两步分析流程

改造内容

相对原始 wedecode，这个仓库主要增加和收敛了这些能力：

• 新增 STDIO 模式的 MCP Server 入口
• 提供 scan_local_miniapps、decompile_scanned_miniapp 等面向 MCP 的工具
• 将反编译流程包进独立子进程，避免底层 process.exit 直接带崩 MCP 进程
• 增加输出目录和文件读取的安全约束
• 修复 VM / jsdom 运行时在部分小程序上的 DOM 绑定问题
• 补充 Cherry Studio 提示词模板和部署文档

工具列表

当前 MCP Server 提供这些工具：

• scan_local_miniapps
• decompile_packages
• decompile_scanned_miniapp
• list_jobs
• list_output_files
• read_output_file

快速开始

1. 克隆仓库

git clone https://github.com/d-rn/MCP-WEDECODEMCP.git
cd MCP-WEDECODEMCP

2. 安装依赖

npm install

3. 构建

npm run build

4. 启动 MCP Server

npm run mcp

或者直接运行构建产物：

node dist\mcp\wedecode-mcp.js

Cherry Studio 配置

在 Cherry Studio 中新增一个 STDIO 类型 MCP Server，核心配置可以直接用下面这份：

{
  "mcpServers": {
    "wedecode": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "D:\\tools\\MCP-WEDECODEMCP\\dist\\mcp\\wedecode-mcp.js"
      ],
      "env": {
        "WEDECODE_MCP_OUTPUT_ROOT": "D:\\tools\\wedecode-output"
      }
    }
  }
}

如果 Cherry Studio 使用的是单个服务项格式，可以改用：

{
  "name": "wedecode",
  "type": "stdio",
  "command": "C:\\Program Files\\nodejs\\node.exe",
  "args": [
    "D:\\tools\\MCP-WEDECODEMCP\\dist\\mcp\\wedecode-mcp.js"
  ],
  "env": {
    "WEDECODE_MCP_OUTPUT_ROOT": "D:\\tools\\wedecode-output"
  }
}

推荐使用流程

如果用户没有直接给出本地 wxapkg 路径，推荐在 Cherry Studio 中走两步：

第一步：扫描本机小程序

扫描我本机的微信小程序，列出前 10 个给我选。

第二步：用户选择目标

分析第 3 个。

或者：

分析 item_id=abc123def456 的那个小程序。

如果用户已经知道具体 wxapkg 路径，可以直接说：

直接反编译这个 wxapkg，并读取 app.json 给我看：
C:\path\to\__APP__.wxapkg

提示词模板

仓库里已经放好了 Cherry Studio 可直接粘贴的提示词模板：

• prompts/cherry-studio/security-audit.md
• prompts/cherry-studio/reverse-analysis.md

一键打包

如果你要把这个项目继续打包发给别人，可以直接使用仓库内置脚本：

npm run package:runtime

生成运行包。

npm run package:source

生成源码包。

npm run package:all

同时生成两种 zip，默认输出到 release/ 目录。

安装和打包文档

更详细的说明见：

• docs/INSTALL-DEPLOY.md
• docs/GITHUB-HOMEPAGE.md
• docs/RELEASE-v0.1.0.md
• MCP.md
• NOTICE.md

原项目说明

本项目是基于 wedecode 改造而来，不是原项目官方仓库。

• 原项目：wedecode
• 原仓库：https://github.com/biggerstar/wedecode
• 当前仓库聚焦：MCP Server、Cherry Studio 接入、本机扫描和分析工作流

在继续分发、修改或二次发布时，请一并保留原项目来源说明和许可证信息。

License

沿用原项目许可证：GPL-3.0-or-later。详见 LICENSE。