Android 逆向工程 MCP 工具套件

---

项目简介

本项目是一个 Android 逆向工程工具集合，通过 MCP (Model Context Protocol) 协议将 AI 助手与专业的 Android 反编译工具连接起来，实现智能化的 APK 分析与修改。

包含组件

组件	说明	路径
JADX MCP Server	与 JADX-GUI 集成的 MCP 服务器，提供实时反编译分析	tools/jadx/
APKTool MCP Server	基于 APKTool 的 MCP 服务器，支持 APK 解码/编码与 Smali 修改	tools/apktool/
ADB MCP Server	Android Debug Bridge MCP 服务器，提供设备管理和调试功能	tools/adb/
Sign Tools MCP Server	APK 签名工具 MCP 服务器，支持密钥管理和签名验证	tools/sign-tools/
Static Analyzer	静态分析增强工具，提供权限、字符串、SDK 识别	tools/static-analyzer/
Diff Tool	文件对比工具，支持 APK、Smali、资源文件对比	tools/diff/
Frida MCP Server	动态插桩分析工具，支持 Hook 和内存操作	tools/frida/

---

功能特性

JADX MCP Server

• 实时获取当前选中的类代码
• 搜索类、方法、字段
• 获取 AndroidManifest.xml 内容
• 获取资源文件（strings.xml 等）
• 重命名类/方法/字段/变量（代码重构）
• 调试器集成（获取堆栈帧、线程、变量）
• 交叉引用分析（查找类/方法/字段的引用）
• 支持分页查询大结果集

APKTool MCP Server

• APK 解码与编码（反编译/重打包）
• Smali 代码浏览与修改
• 资源文件管理
• 项目结构分析
• 文件内容搜索
• 自动备份机制
• 工作空间管理

ADB MCP Server

• 设备连接状态管理
• APK 安装/卸载
• 应用包信息查询
• 日志捕获（logcat）
• Shell 命令执行
• 文件传输（push/pull）
• 屏幕截图
• 应用启动/停止控制

Sign Tools MCP Server

• 密钥库生成与管理
• APK 签名（V1/V2/V3）
• 签名验证
• zipalign 对齐优化
• 密钥信息查询

Static Analyzer

• 权限分析（识别危险权限）
• 字符串资源提取
• URL/IP/API 端点提取
• 第三方 SDK 识别
• 完整静态分析报告

Diff Tool

• APK 文件对比
• Smali 文件行级对比
• 资源目录对比
• 通用文本文件对比

Frida MCP Server

• 进程列表和附加
• JavaScript 脚本注入
• 函数 Hook
• 网络请求拦截
• 内存扫描和读写
• 模块枚举

---

系统要求

环境	版本要求
Windows	Windows 10/11
Python	3.10 或更高版本
Java	OpenJDK 17 (已包含在 tools/bin/jre 中)
内存	建议 8GB 或更高

---

快速开始

1. 安装依赖

使用统一命令行工具安装所有依赖：

# 安装所有工具的依赖
python apkmcp.py install

# 或安装指定工具的依赖
python apkmcp.py install apktool

2. 生成 MCP 配置

# 生成 MCP 配置文件（保存到 .trae/config.json）
python apkmcp.py config

# 预览配置内容
python apkmcp.py config -p

# 保存到指定路径
python apkmcp.py config -o my-config.json

3. 启动 MCP Servers

方式一：使用统一命令行工具（推荐）

# 查看工具状态
python apkmcp.py status

# 列出所有工具
python apkmcp.py list

# 启动指定工具
python apkmcp.py start apktool

方式二：使用启动脚本

# 启动所有服务器
python start_all_servers.py

# 启动指定服务器
python start_all_servers.py --servers jadx,apktool,adb

# 使用 Windows 批处理脚本
start-servers.bat all

方式三：手动启动

# 启动 JADX MCP Server（Java 版本）
cd tools/jadx
tools/bin/jre/bin/java.exe -jar server.jar

# 启动 APKTool MCP Server
python tools/apktool/server.py --workspace tools/workspace/apktool --apktool-path tools/bin/apktool.bat

# 启动 ADB MCP Server
python tools/adb/server.py --adb-path tools/bin/adb.exe

# 启动 Sign Tools MCP Server
python tools/sign-tools/server.py --workspace tools/workspace/sign-tools

# 启动 Static Analyzer
python tools/static-analyzer/server.py

# 启动 Diff Tool
python tools/diff/server.py

# 启动 Frida MCP Server
python tools/frida/server.py

---

配置 MCP 客户端

Trae IDE 配置

在 Trae IDE 中使用本项目，配置已自动生成到 .trae/config.json，所有路径使用相对路径：

{
  "mcpServers": {
    "jadx-mcp-server": {
      "type": "stdio",
      "enabled": true,
      "description": "JADX MCP 服务器 - Java 反编译分析",
      "command": "tools/bin/jre/bin/java.exe",
      "args": ["-jar", "tools/jadx/server.jar"]
    },
    "apktool-mcp-server": {
      "type": "stdio",
      "enabled": true,
      "description": "APKTool MCP 服务器 - APK 解码/编码",
      "command": "python",
      "args": [
        "tools/apktool/server.py",
        "--workspace", "tools/workspace/apktool",
        "--apktool-path", "tools/bin/apktool.bat"
      ]
    },
    "adb-mcp-server": {
      "type": "stdio",
      "enabled

... [View full README on GitHub](https://github.com/kggzs/ApkMCP-Auto#readme)