返回 MCP 目录
public公开dns本地运行

jadx-mcp-server

JADX-MCP-SERVER是一个与JADX-AI-MCP插件配合使用的Python服务器,通过MCP协议让LLM(如Claude)能够实时分析Android APK的反编译代码,提供漏洞检测、代码理解等逆向工程功能。

article

README

🚀 JADX-AI-MCP 项目

JADX-AI-MCP 是一款开源工具,专为 Android 应用程序的反编译和静态分析提供增强功能。它将人工智能(AI)模型与 Model Context Protocol(MCP)相结合,让逆向工程变得更智能、更高效,助力开发者、安全研究人员和学术人员轻松开展应用程序分析工作。

🚀 快速开始

  1. 下载并安装 JDK(建议版本 8 或更高)。
  2. 配置环境变量,确保 PATH 包含 jadx-ai-mcp 工具路径。
  3. 使用以下命令进行基本反编译:
jadx -d output_directory --mcp-enable <input APK file>
  1. 启用 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>

📚 详细文档

主要功能

  1. 静态分析增强
    • 代码解析与反编译
    • 源码结构可视化
    • 类型恢复与修复
  2. 动态插件支持
    • 支持多种语言(如 Python、JavaScript)编写 MCP 插件
    • 动态加载/卸载插件,实时生效
  3. AI 辅助功能
    • 代码理解与注释生成
    • 漏洞检测与修复建议
    • 自动重构与优化
  4. 扩展性设计
    • 支持多种反编译工具(如 jadx、smali)
    • 支持多平台 APK 分析

未来规划

  • 支持更多语言:增加对 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 仓库 或参考相关文档。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端