jadx MCP 安装教程（Claude Code + jadx-gui 实时 APK 分析）

jadx MCP 安装教程（Claude Code + jadx-gui 实时 APK 分析）

2026-08-18 Windows 11 实测通过。架构：Claude Code 通过 MCP 协议实时分析 jadx-gui 中打开的 APK。

一、架构原理

Claude Code ──stdio(MCP)──> jadx_mcp_server.py ──HTTP :8650──> jadx-ai-mcp 插件（jadx-gui 内）
                                (Python venv)                    （加载 APK 后自动监听）

组件	作用	项目地址
jadx-gui 1.5.6	APK 反编译 GUI（含 JRE 版）	github.com/skylot/jadx
jadx-ai-mcp 插件	装进 jadx，在 8650 端口暴露反编译能力	github.com/zinja-coder/jadx-ai-mcp
jadx-mcp-server	Python 桥，MCP 协议 <-> 8650	github.com/zinja-coder/jadx-mcp-server

二、前置条件

依赖	要求	本机实测
Java	11+（jadx with-jre 版可免）	Java 21 ✅
Python	3.10+	3.14.3 ✅
uv	Python 包管理器	手动安装

三、安装步骤

第 1 步：安装 jadx-gui + 插件

1. 下载 jadx-gui-<版本>-with-jre-win.zip（自带 JRE，免装 Java）：
   https://github.com/skylot/jadx/releases
2. 解压到固定目录，本机为 D:\安全工具\jadx\jadx-gui-1.5.6-with-jre-win
3. 安装插件（命令行一行搞定，需 jadx\bin 在 PATH）：

   jadx plugins --install "github:zinja-coder:jadx-ai-mcp"
   

   备选：从 https://github.com/zinja-coder/jadx-ai-mcp/releases 下载
   jadx-ai-mcp-<version>.jar 放在指定目录，jadx-gui -> Plugins -> Install plugin 手动安装。

第 2 步：安装 uv

PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装后位于 C:\Users\<用户>\.local\bin\uv.exe。

第 3 步：部署 jadx-mcp-server

git clone https://github.com/zinja-coder/jadx-mcp-server.git D:\安全工具\jadx\jadx-mcp-server
cd D:\安全工具\jadx\jadx-mcp-server
uv venv                                  # 创建 .venv
uv pip install -r requirements.txt -p .venv\Scripts\python.exe

⚠️ 坑 1：uv venv 只建空环境，不会自动装依赖。必须再执行
uv pip install -r requirements.txt（核心依赖 httpx / fastmcp / uvicorn）。

第 4 步：注册到 Claude Code（用户级，所有项目可用）

claude mcp add jadx -s user -- "C:\Users\<用户>\.local\bin\uv.exe" --directory "D:\安全工具\jadx\jadx-mcp-server" run jadx_mcp_server.py

要点：

• uv 用绝对路径，避免会话 PATH 不含 uv
• --directory 指向 server 仓库根目录
• 不加 --http 参数 = stdio 模式（Claude Code 标准方式）

第 5 步：验证

claude mcp list    # 应显示 jadx ... ✔ Connected

然后新开会话（MCP 列表在会话启动时加载，老会话看不到新注册的 server），
会话内执行 /mcp 确认。

四、使用流程

1. 打开 jadx-gui，加载目标 APK（插件自动监听 8650）
2. 新建/进入 Claude Code 会话
3. 直接下达分析任务，例如：
   • "列出这个 APK 的包结构和入口类"
   • "搜索全部 API 端点字符串（http/https/api）"
   • "反编译 XXX 类，分析加密逻辑"
   • "查 Retrofit/OkHttp 接口定义"

五、常见问题（实测踩坑）

现象	原因	解决
老会话 /mcp 显示 No MCP servers	会话启动早于注册	新开会话
/mcp 长时间 connecting	uv 冷启动慢 / 依赖没装	等 30s；确认第 3 步依赖已装
MCP connected 但工具调用报连接错误	jadx-gui 没开或没加载 APK	打开 jadx-gui 并加载 APK（8650 需监听）
下载 GitHub 资源失败	raw.githubusercontent.com 被重置（大陆网络）	改用 api.github.com（curl -H "Accept: application/vnd.github.raw" .../readme）；release 文件走浏览器/代理下载
claude mcp add 后启动即失败	注册了不存在的命令	先完成第 3 步再注册；command 用绝对路径

六、卸载/回退

claude mcp remove jadx -s user      # 取消注册
# 删除目录 D:\安全工具\jadx\jadx-mcp-server 与 jadx 重装版即可，无系统级残留

七、备选方案（无 MCP）

不需要实时交互时，直接 CLI 全量反编译 + Claude 读文件即可（覆盖 90% 场景）：

jadx -d <输出目录> <目标.apk>

Claude 用 Grep/Read 直接分析反编译产物，与 MCP 方式互补。