🛠️ Jadx MCP 插件 —— 通过 MCP 实现 Claude 对 Jadx 的反编译访问

该项目提供了一个基于 Java 编写的 Jadx 插件，该插件通过 Jadx API 提供 HTTP 接口服务，使得像 Claude 这样的工具可以通过 模型上下文协议 (MCP) 实现实时交互。一个轻量级的 FastMCP 适配器使用 Python 担任桥梁的角色，连接 Claude 和该插件。这使得智能导航和自动化反编译工作流程变得可能，非常适合通过 AI 辅助进行 Android 应用的安全分析。

📝 安装说明

# 克隆此仓库
git clone https://github.com/mobilehackinglab/jadx-mcp-plugin.git
cd jadx-mcp-plugin

# 创建并激活虚拟环境
python3 -m venv venv

# 激活：
source venv/bin/activate      # Linux/Mac
.\venv\Scripts\activate       # Windows

安装 Python 依赖项

pip install -r requirements.txt 

🧠 集成 Claude MCP 客户端工具配置

要在 Claude Desktop 中使用此适配器，请转到 File -> Settings -> Developer -> Edit Config -> claude_desktop_config.json，并添加一个指向 Python 虚拟环境的 MCP 服务器设置（以避免依赖问题），然后指定完整的适配器路径，如下示例所示：

Windows:

{
  "mcpServers": {
    "Jadx MCP Server": {
      "command": "C:\\Workset\\jadx-mcp-plugin\\venv\\Scripts\\python.exe",
      "args": ["C:\\Workset\\jadx-mcp-plugin\\fastmcp_adapter.py"]
    }
  }
}

MacOS / Linux:

{
  "mcpServers": {
    "Jadx MCP Server": {
      "command": "/home/user/jadx-mcp-plugin/venv/bin/python",
      "args": ["python", "-m", "fastmcp_adapter"]
    }
  }
}

配置完成后，确保 Jadx 已经启动并运行。

📝 使用流程

1. 启动 Jadx：首先打开 Jadx 并加载目标文件。
2. 启动 Claude：在另一个终端中启动 Claude，并连接到 Jadx 的 MCP 服务器。
3. 使用工具：通过 Claude 提供的 MCP 接口调用反编译功能。

🛠️ 提供的工具

以下是插件支持的主要功能：

🛠️ 开发信息

Java 插件开发

自动化构建

使用 Gradle 脚本自动构建插件：

./gradlew build

构建输出为 plugin/build/libs/jadx-mcp-plugin-<version>.jar

手动安装

将生成的 JAR 文件手动复制到 Jadx 的 plugins 目录中，路径通常为：~/.jadx/plugins/

然后通过以下命令启用插件：

jadx plugins --enable jadx-mcp

Python FastMCP 适配器

文件路径：

fastmcp_adapter.py

该脚本将 Claude 的 MCP 工具调用转换为对运行中的 Jadx 插件服务器的 HTTP POST 请求。确保在启动 Claude 之前已启动并打开了 Jadx。

🤝 贡献指南

欢迎提交 PR、功能请求和工具扩展！
该项目由 Mobile Hacking Lab 维护。

🧩 致谢

• Jadx
• FastMCP
• Claude by Anthropic