Jadx MCP Plugin

🚀 🛠️ 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