Jadx Mcp Plugin

⚙️ Jadx MCP プラグイン — MCP 経由で Claude から逆コンパイラーにアクセス

このプロジェクトでは、Java で記述された Jadx プラグインを提供しています。このプラグインは Jadx API を HTTP 経由で公開し、Model Context Protocol (MCP) を通じて、Claude などの MCP クライアントからリアルタイムに操作できるようにします。Python 製の軽量な FastMCP アダプターが、Claude とプラグインの橋渡しをします。これにより、リバースエンジニアリングのワークフローをインテリジェントにナビゲートして自動化でき、Android アプリの AI 支援セキュリティ分析に最適です。

---

🧰 セットアップ手順

# Clone this repository
git clone https://github.com/mobilehackinglab/jadx-mcp-plugin.git
cd jadx-mcp-plugin

# Create and activate a virtual environment
python3 -m venv venv

# Activate:
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": "/Users/yourname/jadx-mcp-plugin/venv/bin/python",
      "args": ["/Users/yourname/jadx-mcp-plugin/fastmcp_adapter.py"]
    }
  }
}

設定を編集した後、Claude を再起動（終了）してください。 再起動後、次のように表示されます。

✅ 使用の流れ

1. リリースから最新のプラグイン JAR を入手して plugins/ フォルダーに配置するか、Plugins -> install plugin から読み込み、Jadx を起動します。

2. APK または DEX ファイルを読み込みます

3. （任意）次のコマンドで Jadx を起動し、HTTP インターフェースのアドレスを指定できます。

   jadx-gui -Pjadx-mcp.http-interface=http://localhost:8085
   

   これは、デフォルトのホスト／ポート（http://localhost:8085）を変更したい場合に便利です。

   注： ここでインターフェースのアドレスを変更した場合は、fastmcp_adapter.py 内の対応する URL も一致するように更新してください。

4. Claude が Jadx MCP サーバーのツールを検出して有効化します。

5. クラスの一覧表示、ソースの取得、メソッド／フィールドの調査、コードのリアルタイム抽出ができるようになります。

---

🧪 提供されるツール

ツール	説明
list_all_classes	すべての逆コンパイル済みクラス名を取得
search_class_by_name	文字列に一致するクラスを検索
get_class_source	指定したクラスのソース全体を取得
search_method_by_name	文字列に一致するメソッドを検索
get_methods_of_class	クラス内のすべてのメソッド名を一覧表示
get_fields_of_class	クラス内のすべてのフィールド名を一覧表示
get_method_code	メソッドの逆コンパイル済みコードを抽出

---

🛠 開発

☕ Java プラグイン

Java プラグインの場所：

plugin/src/main/java/com/mobilehackinglab/jadxplugin/McpPlugin.java

JadxPlugin API（jadx.api.*）を使用して、次の処理を行います。

• 逆コンパイル済みのクラスとメソッドを読み込む
• 組み込み HTTP サーバー経由で構造化データを提供する
• /invoke および /tools エンドポイントに応答する

🚀 Gradle タスクによる自動インストール

次の Gradle タスクを使うと、プラグインのビルドとインストールを一度に実行できます。

./gradlew installPlugin

これは jadx plugins CLI を使用します。Jadx がインストールされ、PATH から利用できることを確認してください。

アンインストール、有効化／無効化など、その他のプラグイン関連タスクについては、plugin/build.gradle のタスク定義を参照してください。

🔧 手動インストール

プラグインをビルドするには：

./gradlew build
# Output: plugin/build/libs/jadx-mcp-plugin-<version>.jar

jadx plugins CLI を使用してプラグイン JAR をインストールします。

jadx plugins --install-jar path/to/jadx-mcp-plugin-<version>.jar

または、ビルドした .jar ファイルを Jadx の plugins/ フォルダーに配置します。通常の場所は ~/.jadx/plugins/ です。

JAR を手動で配置した場合は、Jadx の GUI から、または次のコマンドを実行してプラグインを有効にする必要があります。

jadx plugins --enable jadx-mcp

---

Python FastMCP アダプター

アダプターファイルの場所：

fastmcp_adapter.py

このアダプターは、Claude の MCP ツール呼び出しを、実行中の Jadx プラグインサーバーへの HTTP POST リクエストに変換します。Claude を起動する前に Jadx を開いてください。

---

🤝 貢献

PR、機能リクエスト、ツールの拡張を歓迎します！
このプロジェクトは Mobile Hacking Lab がメンテナンスしています。

---

🧩 クレジット

• Jadx
• FastMCP
• Anthropic の Claude