README
🚀 JADX-AI-MCP 项目
JADX-AI-MCP 是一款开源工具,专为 Android 应用程序的反编译和静态分析提供增强功能。它将人工智能(AI)模型与 Model Context Protocol(MCP)相结合,让逆向工程变得更智能、更高效,助力开发者、安全研究人员和学术人员轻松开展应用程序分析工作。
🚀 快速开始
- 下载并安装 JDK(建议版本 8 或更高)。
- 配置环境变量,确保
PATH包含 jadx-ai-mcp 工具路径。 - 使用以下命令进行基本反编译:
jadx -d output_directory --mcp-enable <input APK file>
- 启用 AI 辅助功能:
jadx -i --ai-enable <input APK file>
✨ 主要特性
- AI 增强分析:集成 AI 模型,辅助代码理解、漏洞检测和代码重构。
- Model Context Protocol (MCP):支持通过 MCP 协议与外部模型服务通信,实现动态功能扩展。
- 多平台兼容性:适用于 Windows、macOS 和 Linux 系统。
📦 安装指南
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>
📚 详细文档
主要功能
- 静态分析增强
- 代码解析与反编译
- 源码结构可视化
- 类型恢复与修复
- 动态插件支持
- 支持多种语言(如 Python、JavaScript)编写 MCP 插件
- 动态加载/卸载插件,实时生效
- AI 辅助功能
- 代码理解与注释生成
- 漏洞检测与修复建议
- 自动重构与优化
- 扩展性设计
- 支持多种反编译工具(如 jadx、smali)
- 支持多平台 APK 分析
未来规划
- 支持更多语言:增加对 Python、JavaScript 等语言的原生支持。
- 集成 Hermes 解码:增强对 React Native 应用的支持。
- 扩展 MCP 工具集:开发更多实用的 MCP 插件。
- 本地 LLM 支持:实现与本地 AI 模型的无缝对接。
贡献指南
欢迎任何贡献!无论是问题报告、功能建议还是代码提交,我们都热烈欢迎:
- 提交 Issues 报告问题或提出建议。
- Fork 仓库进行代码修改,并发起 Pull Request。
- 分享使用心得或集成案例。
📄 许可证
本项目继承了 Apache 2.0 许可证,允许用户自由使用、修改和分发。详细许可信息请参考 LICENSE 文件。
⚠️ 注意事项
⚠️ 重要提示
JADX-AI-MCP 工具仅限于教育、研究及合法的安全评估用途。使用者需确保其行为符合相关法律法规和道德规范。任何未经授权的应用,如用于未经授权的代码分析或侵犯知识产权的行为,均属违规使用,开发者概不负责。请在合法、授权范围内使用本工具,并遵循相应的行为准则。
🙏 感谢与鸣谢
感谢 @skylot 开发了 jadx 原始版本。感谢开源社区的贡献者们,以及所有支持和参与此项目的人士。
更多详细信息,请访问 GitHub 仓库 或参考相关文档。
扫码联系在线客服