内容
# Android 逆向工程 MCP 工具套件
<div align="center">
⚡ 基于 Model Context Protocol (MCP) 的 Android APK 自动化逆向工程工具套件
[](https://www.python.org/)
[](https://openjdk.org/)
[](https://www.apache.org/licenses/LICENSE-2.0)
</div>
---
## 项目简介
本项目是一个 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. 安装依赖
使用统一命令行工具安装所有依赖：
```bash
# 安装所有工具的依赖
python apkmcp.py install
# 或安装指定工具的依赖
python apkmcp.py install apktool
```
### 2. 生成 MCP 配置
```bash
# 生成 MCP 配置文件（保存到 .trae/config.json）
python apkmcp.py config
# 预览配置内容
python apkmcp.py config -p
# 保存到指定路径
python apkmcp.py config -o my-config.json
```
### 3. 启动 MCP Servers
#### 方式一：使用统一命令行工具（推荐）
```bash
# 查看工具状态
python apkmcp.py status
# 列出所有工具
python apkmcp.py list
# 启动指定工具
python apkmcp.py start apktool
```
#### 方式二：使用启动脚本
```bash
# 启动所有服务器
python start_all_servers.py
# 启动指定服务器
python start_all_servers.py --servers jadx,apktool,adb
# 使用 Windows 批处理脚本
start-servers.bat all
```
#### 方式三：手动启动
```bash
# 启动 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`，所有路径使用相对路径：
```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](https://github.com/skylot/jadx) - 优秀的 Android 反编译工具
- [APKTool](https://github.com/iBotPeaches/Apktool) - 强大的 APK 反编译/重打包工具
- [FastMCP](https://github.com/modelcontextprotocol/python-sdk) - Python MCP SDK
- [Anthropic MCP](https://github.com/anthropics/mcp) - Model Context Protocol
- [Frida](https://frida.re/) - 动态插桩工具包
---
<div align="center">
**Made with ❤️ for Android Reverse Engineering**
</div>
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器