# ApkMCP-Auto

**Repository Path**: loadymf/ApkMCP-Auto

## Basic Information

- **Project Name**: ApkMCP-Auto
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android 逆向工程 MCP 工具套件

<div align="center">

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

[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
[![Java](https://img.shields.io/badge/Java-17-blue)](https://openjdk.org/)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](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>