JADX-AI-MCP 项目简介

JADX-AI-MCP 是一个为 Android 应用程序反编译和静态分析提供增强功能的开源工具。它通过结合人工智能（AI）模型与 Model Context Protocol（MCP），使逆向工程更加智能化、高效化。该项目旨在帮助开发者、安全研究人员及学术人员更轻松地进行应用程序分析。

功能特点

• AI 增强分析：集成 AI 模型，辅助代码理解、漏洞检测和代码重构。
• Model Context Protocol (MCP)：支持通过 MCP 协议与外部模型服务通信，实现动态功能扩展。
• 多平台兼容性：适用于 Windows、macOS 和 Linux 系统。

主要功能

1. 静态分析增强

   • 代码解析与反编译
   • 源码结构可视化
   • 类型恢复与修复

2. 动态插件支持

   • 支持多种语言（如 Python、JavaScript）编写 MCP 插件
   • 动态加载/卸载插件，实时生效

3. AI 辅助功能

   • 代码理解与注释生成
   • 漏洞检测与修复建议
   • 自动重构与优化

4. 扩展性设计

   • 支持多种反编译工具（如 jadx、smali）
   • 支持多平台 APK 分析

安装指南

1. 下载 jadx-ai-mcp 工具包

从 GitHub 下载最新版本的工具包，解压后即可获得 jadx、mcp_server 及相关文档。

2. 安装与配置

Windows 系统

# 添加环境变量
set PATH=%PATH%;C:\path\to\jadx-ai-mcp

macOS/Linux 系统

# 添加到 PATH 环境变量
export PATH=$PATH:/path/to/jadx-ai-mcp

3. 启动 jadx 服务

在终端中运行以下命令启动 jadx 分析服务：

jadx -d <directory> --mcp-enable

4. 配置 MCP 插件

创建 config.json 文件，添加所需的 MCP 插件配置：

{
    "plugins": [
        {
            "name": "security-check",
            "url": "http://localhost:8080"
        }
    ]
}

5. 使用 AI 辅助功能

运行以下命令，利用 AI 模型进行代码分析：

jadx -i --ai-enable <your APK file>

快速上手

1. 下载并安装 JDK（建议版本 8 或更高）。
2. 配置环境变量，确保 PATH 包含 jadx-ai-mcp 工具路径。
3. 使用以下命令进行基本反编译：

   jadx -d output_directory --mcp-enable <input APK file>
   

4. 启用 AI 辅助功能：

   jadx -i --ai-enable <input APK file>
   

未来规划

• 支持更多语言：增加对 Python、JavaScript 等语言的原生支持。
• 集成 Hermes 解码：增强对 React Native 应用的支持。
• 扩展 MCP 工具集：开发更多实用的 MCP 插件。
• 本地 LLM 支持：实现与本地 AI 模型的无缝对接。

贡献指南

欢迎任何贡献！无论是问题报告、功能建议还是代码提交，我们都热烈欢迎：

1. 提交 Issues 报告问题或提出建议。
2. Fork 仓库进行代码修改，并发起 Pull Request。
3. 分享使用心得或集成案例。

授权协议

本项目继承了 Apache 2.0 许可证，允许用户自由使用、修改和分发。详细许可信息请参考 LICENSE 文件。

注意事项

免责声明

JADX-AI-MCP 工具仅限于教育、研究及合法的安全评估用途。使用者需确保其行为符合相关法律法规和道德规范。任何未经授权的应用，如用于未经授权的代码分析或侵犯知识产权的行为，均属违规使用，开发者概不负责。

请在合法、授权范围内使用本工具，并遵循相应的行为准则。

感谢与鸣谢

感谢 @skylot 开发了 jadx 原始版本。感谢开源社区的贡献者们，以及所有支持和参与此项目的人士。

更多详细信息，请访问 GitHub 仓库 或参考相关文档。