JADX-AI-MCP 是 JADX 反编译器的插件,用于将 MCP(Model Context Protocol)服务器集成到 JADX 中,从而让 LLM(如 Claude)能够实时与反编译后的 Android 应用上下文通信,实现“反编译 → 上下文感知代码审查 → AI 建议”的实时工作流。它属于 Zin MCP Suite 的一部分,同系列还有 APKTool-MCP-Server 和 JADX-MCP-Server。
主要能力:该工具由两部分组成——JADX MCP 服务器(独立的 Python 服务器)和 JADX-AI-MCP 插件。插件负责与 JADX-GUI 交互,服务器通过 MCP 协议让 LLM 访问反编译上下文。当前提供的 MCP 工具包括:获取当前选中类的名称和完整源码、获取当前选中文本、列出项目中所有类、获取指定类的完整源码、按名称获取方法源码、按名称搜索方法、按关键字搜索类(支持分页)、列出类的方法和字段、获取类的 smali 代码、获取 AndroidManifest.xml 中声明的主 Activity 类、根据包名获取主应用类的代码和名称、获取 AndroidManifest.xml 内容、获取特定 manifest 组件、获取 strings.xml、获取所有资源文件名、获取资源文件内容、重命名类/方法/字段/包/变量、添加注释(可针对类、方法、字段或单行代码,注释显示在 JADX-GUI 中并随项目保存)、列出项目中的注释、获取调试器堆栈帧/线程/变量、查找类/方法/字段的交叉引用(支持分页)。
使用方式:从 GitHub Releases 下载 jadx-ai-mcp-<version>.jar 和 jadx-mcp-server-<version>.zip。配置 MCP 客户端(如 Claude Desktop 的 claude_desktop_config.json,Windows 路径为 %APPDATA%\Claude\claude_desktop_config.json,macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json),填入 uv 可执行文件路径和 jadx-mcp-server 的绝对路径。也可将 jadx_mcp_server 直接安装为可执行文件,在 MCP 配置的 command 中直接使用。支持 Cherry Studio、LM Studio(配置 mcp.json)等客户端。支持 HTTP 流模式,使用 --http 选项运行 jadx_mcp_server.py。插件提供自定义端口、恢复默认端口、重启服务器、查看服务器状态等 GUI 操作;连接自定义端口时使用 --jadx-port 选项,连接远程 JADX 时使用 --jadx-host 选项。
适用场景:Android APK 的快速分析、漏洞查找、逆向工程辅助、静态分析、AI 代码修改、文档与元数据查看、调试辅助等。
限制与安全警告:当使用 --host 0.0.0.0(或任何非 localhost 地址)时,MCP 服务器会绑定到所有网络接口,使用明文 HTTP 且无身份验证,网络上的任何人都可以连接并调用所有 MCP 工具,且无 TLS 加密,流量可被拦截;攻击者可利用服务器读取反编译代码、重命名类/方法、访问调试信息。因此仅应在受信任的隔离网络(如 Docker 桥接、本地 VM)中绑定 0.0.0.0,使用防火墙限制 MCP 端口访问,或考虑使用 SSH 隧道(ssh -L 8651:127.0.0.1:8651 remote-host)。在 stdio 模式(默认,不带 --http)下,所有人类可读输出(横幅、健康检查)写入 stderr,以保持 stdout 专用于 MCP JSON-RPC 流,确保与 Codex、Claude Desktop 等基于 stdio 的 MCP 客户端兼容。项目继承 JADX 的 Apache 2.0 许可证,仅限教育、研究和道德安全评估用途,用户需确保在授权环境中使用。