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 のプラグインディレクトリにコピーします。通常のパスは ~/.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