Apk MCP Auto

Android 逆向工程 MCP 工具套件

⚡ 基于 Model Context Protocol (MCP) 的 Android APK 自动化逆向工程工具套件

  

项目简介

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

包含组件

功能特性

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
• 网络请求拦截
• 内存扫描和读写
• 模块枚举

系统要求

快速开始

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": true,
      "description": "ADB MCP 服务器 - 设备管理和调试",
      "command": "python",
      "args": [
        "tools/adb/server.py",
        "--adb-path", "tools/bin/adb.exe"
      ]
    },
    "sign-tools-mcp-server": {
      "type": "stdio",
      "enabled": true,
      "description": "签名工具 MCP 服务器 - APK 签名和密钥管理",
      "command": "python",
      "args": [
        "tools/sign-tools/server.py",
        "--workspace", "tools/workspace/sign-tools"
      ]
    },
    "static-analyzer": {
      "type": "stdio",
      "enabled": true,
      "description": "静态分析工具 - 权限、字符串、SDK 识别",
      "command": "python",
      "args": ["tools/static-analyzer/server.py"]
    },
    "diff-tool": {
      "type": "stdio",
      "enabled": true,
      "description": "文件对比工具 - APK、Smali、资源对比",
      "command": "python",
      "args": ["tools/diff/server.py"]
    },
    "frida-mcp-server": {
      "type": "stdio",
      "enabled": true,
      "description": "Frida MCP 服务器 - 动态插桩分析",
      "command": "python",
      "args": ["tools/frida/server.py"]
    }
  }
}

配置说明：

• 所有路径使用相对路径，项目可以移动到任意位置使用
• 运行 python apkmcp.py config 可自动重新生成配置

使用示例

分析 APK 文件

# 使用 APKTool MCP Server 解码 APK
请帮我解码 APK 文件 test.apk

# 分析完成后可以查看
- AndroidManifest.xml
- Smali 代码
- 资源文件
- 项目结构

代码审查与安全分析

# 使用 JADX MCP Server 分析代码
请帮我分析当前选中的类是否存在安全漏洞

# 搜索特定代码模式
搜索包含 "AES" 加密的类

# 查找引用
查找哪些方法调用了 sendRequest 方法

设备调试

# 使用 ADB MCP Server 连接设备
列出已连接的 Android 设备

# 安装 APK
安装 APK 文件到设备

# 获取日志
捕获应用的日志信息

APK 签名

# 使用 Sign Tools MCP Server 生成密钥
生成一个新的密钥库用于签名

# 签名 APK
对修改后的 APK 进行签名

# 验证签名
验证 APK 签名是否正确

静态分析

# 使用 Static Analyzer 分析 APK
分析 APK 的权限和潜在风险

# 提取字符串
提取 APK 中的所有字符串资源

# 识别 SDK
识别 APK 中使用的第三方 SDK

文件对比

# 使用 Diff Tool 对比 APK
对比原始 APK 和修改后的 APK

# 对比 Smali 文件
对比两个 Smali 文件的差异

动态分析

# 使用 Frida MCP Server 进行动态分析
列出设备上运行的进程

# Hook 函数
Hook 目标应用的指定函数

# 拦截网络请求
拦截应用的网络通信

提示词模板

本项目提供了专门的 APK 逆向工程分析提示词模板，方便快速进行各类分析：

提示词模板文件

📄 文件位置: prompt_template.md

包含的提示词类型

使用方法

1. 打开 prompt_template.md 文件
2. 选择需要的提示词模板
3. 复制到 AI 助手
4. 替换 [APK文件路径] 和 [工作目录]
5. AI 会自动调用 MCP 工具执行分析并生成报告

项目结构

ApkMCP-Auto/
├── .trae/
│   └── config.json                 # MCP 配置（自动生成，相对路径）
├── tools/                          # 统一工具目录
│   ├── adb/                        # ADB MCP Server
│   │   ├── server.py
│   │   └── requirements.txt
│   ├── apktool/                    # APKTool MCP Server
│   │   ├── server.py
│   │   └── requirements.txt
│   ├── bin/                        # 二进制工具目录
│   │   ├── adb.exe
│   │   ├── apktool.jar
│   │   ├── apktool.bat
│   │   ├── jadx-gui.exe
│   │   └── jre/                    # Java 运行时
│   ├── diff/                       # Diff Tool
│   │   ├── server.py
│   │   └── requirements.txt
│   ├── frida/                      # Frida MCP Server
│   │   ├── server.py
│   │   └── requirements.txt
│   ├── jadx/                       # JADX MCP Server
│   │   ├── server.jar
│   │   └── requirements.txt
│   ├── sign-tools/                 # Sign Tools MCP Server
│   │   ├── server.py
│   │   └── requirements.txt
│   ├── static-analyzer/            # Static Analyzer
│   │   ├── server.py
│   │   └── requirements.txt
│   └── workspace/                  # 工作空间
│       ├── apktool/
│       └── sign-tools/
├── apkmcp.py                       # 统一命令行工具
├── start_all_servers.py            # 启动所有服务器的脚本
├── start-servers.bat               # Windows 启动脚本
├── prompt_template.md              # APK 逆向分析提示词模板
└── README.md                       # 本文件

可用 MCP 工具

JADX MCP Server 工具

APKTool MCP Server 工具

ADB MCP Server 工具

Sign Tools MCP Server 工具

Static Analyzer 工具

Diff Tool 工具

Frida MCP Server 工具

技术栈

• Python 3.10+ - MCP Server 开发
• FastMCP - MCP 协议实现
• httpx - HTTP 客户端
• APKTool 3.0+ - APK 反编译/重打包
• JADX 1.5+ - Android Dex 反编译
• Java 17 - JADX 运行环境
• ADB - Android 调试桥
• Frida - 动态插桩框架

命令行参数

apkmcp.py 统一命令行工具

各 MCP Server 通用参数

各工具默认端口

工作流程

┌─────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  AI 助手    │◄───►│   MCP Server    │◄───►│   JADX/APKTool  │
│ (Claude等)  │     │ (Python FastMCP)│     │  (Java/命令行)  │
└─────────────┘     └─────────────────┘     └─────────────────┘
       │                     │                      │
       │  1. 发送 MCP 请求    │                      │
       │────────────────────>│                      │
       │                     │  2. 调用工具         │
       │                     │─────────────────────>│
       │                     │                      │
       │                     │  3. 返回结果         │
       │                     │<─────────────────────│
       │  4. 返回 MCP 响应    │                      │
       │<────────────────────│                      │

报告生成

使用提示词模板进行分析后，会自动生成结构化的 Markdown 报告：

报告类型

报告内容结构

每个报告通常包含：

1. 执行摘要 - 分析目标和主要发现
2. 应用概况 - 基本信息和技术栈
3. 详细分析 - 代码位置、逻辑分析
4. 解决方案 - 修改方案和实施步骤
5. 风险评估 - 技术、安全、法律风险
6. 附录 - 代码片段、工具配置

安全提示

1. 仅用于合法的安全研究和学习目的
2. 仅分析您拥有合法权限的应用程序
3. 不要将 MCP Server 绑定到公网地址（使用 --host 0.0.0.0 时请注意）
4. APK 修改后需要重新签名才能安装
5. 分析完成后记得关闭 MCP 工具连接，释放资源

许可证

本项目采用 Apache License 2.0 开源许可证。

致谢

• JADX - 优秀的 Android 反编译工具
• APKTool - 强大的 APK 反编译/重打包工具
• FastMCP - Python MCP SDK
• Anthropic MCP - Model Context Protocol
• Frida - 动态插桩工具包

Made with ❤️ for Android Reverse Engineering