APK Reverse Engineering

---

项目简介

本项目是一个 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": 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

包含的提示词类型

提示词	用途	输出报告
通用 APK 分析	全面的 APK 信息提取和分析	分析报告.md
广告去除专项	定位广告 SDK 和去除方案	广告分析报告.md
会员破解专项	分析会员验证机制	会员分析报告.md
加固分析专项	识别加固方案和脱壳建议	加固分析报告.md
网络分析专项	分析网络通信和拦截点	网络分析报告.md
综合逆向分析	完整的逆向工程流程	逆向分析报告.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 工具

工具名	功能描述
fetch_current_class	获取当前选中的类
get_class_source	获取指定类的源代码
get_all_classes	列出所有类（支持分页）
search_classes_by_keyword	按关键词搜索类
get_method_by_name	获取指定方法的代码
get_methods_of_class	列出类的所有方法
get_fields_of_class	列出类的所有字段
get_smali_of_class	获取类的 Smali 代码
get_android_manifest	获取 AndroidManifest.xml
get_strings	获取字符串资源
get_resource_file	获取资源文件内容
rename_class	重命名类
rename_method	重命名方法
rename_field	重命名字段
rename_variable	重命名变量
debug_get_stack_frames	获取调试堆栈帧
debug_get_variables	获取调试变量
get_xrefs_to_class	查找类的交叉引用
get_xrefs_to_method	查找方法的交叉引用

APKTool MCP Server 工具

工具名	功能描述
decode_apk	解码 APK 文件
build_apk	从项目构建 APK
get_manifest	获取 AndroidManifest.xml
get_apktool_yml	获取 apktool.yml
list_smali_directories	列出 Smali 目录
list_smali_files	列出 Smali 文件（支持分页）
get_smali_file	获取 Smali 文件内容
modify_smali_file	修改 Smali 文件
list_resources	列出资源文件
get_resource_file	获取资源文件内容
modify_resource_file	修改资源文件
search_in_files	在文件中搜索
analyze_project_structure	分析项目结构
clean_project	清理项目
get_workspace_info	获取工作空间信息
health_check	健康检查

ADB MCP Server 工具

工具名	功能描述
health_check	服务器健康检查
list_devices	列出已连接设备
get_device_info	获取设备详细信息
install_apk	安装 APK 文件
uninstall_package	卸载应用包
get_package_info	获取应用包信息
get_logcat	获取设备日志
clear_logcat	清除日志缓冲区
execute_shell	执行 Shell 命令
push_file	推送文件到设备
pull_file	从设备拉取文件
screenshot	截取屏幕
list_packages	列出已安装应用
start_activity	启动 Activity
force_stop_package	强制停止应用

Sign Tools MCP Server 工具

工具名	功能描述
health_check	服务器健康检查
generate_keystore	生成密钥库
list_keystores	列出所有密钥库
get_keystore_info	获取密钥库信息
delete_keystore	删除密钥库
sign_apk	签名 APK 文件
verify_signature	验证 APK 签名
zipalign_apk	对齐优化 APK
get_workspace_info	获取工作空间信息

Static Analyzer 工具

工具名	功能描述
analyze_permissions	分析权限
extract_strings	提取字符串资源
extract_endpoints	提取 URL/IP/API 端点
identify_sdks	识别第三方 SDK
full_analysis	执行完整分析

Diff Tool 工具

工具名	功能描述
compare_apks	对比两个 APK 文件
compare_smali	对比两个 Smali 文件
compare_resources	对比两个资源目录
compare_text_files	对比两个文本文件

Frida MCP Server 工具

工具名	功能描述
list_processes	列出运行中的进程
attach_process	附加到指定进程
spawn_process	启动新进程
inject_script	注入 JavaScript 脚本
hook_function	Hook 指定函数
intercept_network	拦截网络请求
scan_memory	扫描内存
read_memory	读取内存
write_memory	写入内存
enumerate_modules	枚举加载的模块
enumerate_exports	枚举模块导出函数

---

技术栈

• 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 统一命令行工具

命令	说明	示例
status	查看工具状态	python apkmcp.py status
list	列出所有工具	python apkmcp.py list
config	生成 MCP 配置	python apkmcp.py config -p
install [tool]	安装依赖	python apkmcp.py install apktool
start <tool>	启动指定工具	python apkmcp.py start apktool

各 MCP Server 通用参数

参数	默认值	说明
--http	False	启用 HTTP 传输模式
--host	127.0.0.1	MCP 服务器监听地址
--port	各工具不同	MCP 服务器端口

各工具默认端口

工具	默认端口
JADX	8651
APKTool	8652
ADB	8653
Sign Tools	8654
Static Analyzer	8655
Diff Tool	8656
Frida	8657

---

工作流程

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

---

报告生成

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

报告类型

报告名称	内容	保存位置
分析报告.md	通用 APK 分析报告	[工作目录]/分析报告.md
广告分析报告.md	广告 SDK 识别和去除方案	[工作目录]/广告分析报告.md
会员分析报告.md	会员验证机制分析	[工作目录]/会员分析报告.md
加固分析报告.md	加固识别和脱壳方案	[工作目录]/加固分析报告.md
网络分析报告.md	网络通信分析	[工作目录]/网络分析报告.md
逆向分析报告.md	综合逆向工程报告	[工作目录]/逆向分析报告.md

报告内容结构

每个报告通常包含：

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 - 动态插桩工具包

---