APK Editor MCP
一个强大的 Android APK 逆向工程 MCP (Model Context Protocol) 服务器，支持 APK 反编译、修改、重打包，以及快速 DEX 内存编辑。
特性
- 快速 DEX 编辑 - 内存操作，无需解包，秒级打开大型 APK
- Smali 转 Java - 内置 jadx-core，一键反编译
- 智能搜索 - 搜索类名、字符串、方法调用
- 实时修改 - 直接修改 smali 代码并保存
- 批量操作 - 批量反编译整个包
安装
前置要求
安装步骤
# 克隆仓库
git clone https://github.com/your-repo/apk-editor-mcp.git
cd apk-editor-mcp
# 安装依赖
pip install -e .
# 配置 Windsurf/Cursor MCP
MCP 配置
在 ~/.codeium/windsurf/mcp_config.json 中添加：
{
"mcpServers": {
"apk-editor": {
"command": "python",
"args": ["K:/path/to/APK-Editor-MCP-Server/mcp-server/run_server.py"]
}
}
}
工具列表
快速 DEX 编辑器 (推荐)
| 工具 | 说明 |
|------|------|
| fast_dex_open | 打开 APK 加载 DEX 到内存（秒开） |
| fast_dex_list_classes | 列出所有类 |
| fast_dex_search_class | 搜索类名（支持正则） |
| fast_dex_get_class | 获取类的 smali 代码 |
| fast_dex_summary | 获取类摘要（方法列表、代码长度） |
| fast_dex_get_paged | 分页获取 smali（避免超 token） |
| fast_dex_modify_class | 修改类的 smali 代码 |
| fast_dex_save | 保存修改到 APK |
| fast_dex_to_java | smali 转 Java 代码 |
| fast_dex_deobfuscate | 反混淆并转 Java |
| fast_dex_decompile_package | 批量反编译包下所有类 |
| fast_dex_close | 关闭编辑器 |
APK 操作
| 工具 | 说明 |
|------|------|
| apk_decode | 反编译 APK 到目录 |
| apk_build | 从目录构建 APK |
| apk_info | 获取 APK 信息 |
| apk_sign | 签名 APK（默认debug.keystore） |
| apk_verify | 验证 APK 签名 |
| fast_manifest_read | 快速读取 AndroidManifest.xml |
| fast_manifest_modify | 快速修改 AndroidManifest.xml |
| fast_manifest_patch | 快速修补 Manifest（正则替换） |
| apk_merge | 合并分割 APK (XAPK/APKS) |
| apk_protect | 保护/混淆 APK 资源 |
| apk_refactor | 反资源混淆 |
文件操作
| 工具 | 说明 |
|------|------|
| file_list | 列出目录内容 |
| file_read | 读取文件 |
| file_write | 写入文件 |
| file_copy | 复制文件 |
| file_move | 移动文件 |
| file_delete | 删除文件 |
Smali 操作
| 工具 | 说明 |
|------|------|
| smali_parse | 解析 smali 文件结构 |
| smali_get_method | 提取指定方法 |
| smali_replace_method | 替换方法实现 |
| smali_insert_code | 在方法中插入代码 |
| smali_gen_log | 生成 Log.d 调用代码 |
| smali_gen_return | 生成 return 语句代码 |
ADB 工具
| 工具 | 说明 |
|------|------|
| adb_list_devices | 列出所有连接的设备 |
| adb_install | 安装 APK 到设备 |
| adb_uninstall | 卸载应用 |
| adb_logcat | 获取设备日志 |
| adb_screenshot | 截取设备屏幕 |
| adb_device_info | 获取设备详细信息 |
| adb_list_packages | 列出已安装的应用 |
| adb_clear_data | 清除应用数据 |
资源编辑工具
| 工具 | 说明 |
|------|------|
| res_read_strings | 读取 strings.xml |
| res_modify_string | 修改单个字符串 |
| res_batch_modify_strings | 批量修改字符串 |
| res_read_colors | 读取 colors.xml |
| res_modify_color | 修改颜色值 |
| res_search | 搜索资源内容 |
| res_list_files | 列出资源文件 |
| res_read_xml | 读取任意 XML 资源 |
| res_modify_xml | 修改任意 XML 资源 |
| res_add_string | 添加新字符串 |
| res_delete_string | 删除字符串 |
搜索工具
| 工具 | 说明 |
|------|------|
| search_text | 搜索文本内容 |
| search_string | 搜索 smali 字符串常量 |
| search_method | 搜索方法调用 |
| find_class | 查找类文件路径 |
| list_classes | 列出所有 smali 类 |
使用示例
快速破解 VIP
# 1. 打开 APK
fast_dex_open("app.apk")
# 2. 搜索 VIP 相关类
fast_dex_search_class("VipInfo")
# 3. 查看类结构
fast_dex_summary("Lcom/example/VipInfo;")
# 4. 获取并查看代码
fast_dex_to_java("Lcom/example/VipInfo;")
# 5. 修改 isVip 方法返回 true
fast_dex_modify_class("Lcom/example/VipInfo;", new_smali_code)
# 6. 保存
fast_dex_save("app_cracked.apk")
搜索字符串
# 搜索登录相关
fast_dex_search_string("login")
fast_dex_search_string("password")
批量反编译
# 反编译整个包
fast_dex_decompile_package("com.example.app.*")
完整破解流程（含ADB测试）
# 1. 打开APK
fast_dex_open("app.apk")
# 2. 修改VIP验证
fast_dex_modify_class("Lcom/example/VipInfo;", new_smali_code)
# 3. 保存并签名
fast_dex_save("app_cracked.apk")
apk_sign(apk_path="app_cracked.apk")
# 4. 安装到设备测试
adb_list_devices() # 查看连接的设备
adb_install(apk_path="app_cracked_signed.apk", replac
... [View full README on GitHub](https://github.com/1600822305/APK-Editor-MCP-Server#readme)
