Djeb MCP Server

🚀 JEB MCP Server

JEB MCP Serverは、Android APK分析のためにClaude DesktopとJEBデコンパイラを橋渡しするModel Context Protocol (MCP)サーバーです。この統合により、Claude内で直接AI支援のリバースエンジニアリングワークフローを実行できます。

✨ 主な機能

• デコンパイル：DEXからJavaソースコードへのメソッドとクラスのデコンパイル
• コードナビゲーション：クラスの一覧表示、リソースの検索、相互参照の探索
• 一括リネーム：クラス、メソッド、フィールド、ローカル変数の一括リネーム
• リソース分析：AndroidManifest.xml、リソース、アセットファイルへのアクセス
• 相互参照：メソッド、フィールド、文字列へのすべての参照を検索
• クラス階層：クラスの実装と継承関係の探索

🔧 技術詳細

システムは2つのコンポーネントで構成されています。

1. JEB MCP Server (dJEB_mcp_server.py)：JEB内でJythonスクリプトとして実行され、ソケットを介してJEBのAPIを公開します。
2. Bridge Script (jeb_mcp_bridge.py)：Claude Desktopを標準入出力を介してJEBサーバーに接続します。

Claude Desktop <--> jeb_mcp_bridge.py <--> (port 8851) <--> dJEB_mcp_server.py (JEB)

📦 インストール

前提条件

• JEB Decompiler (ライセンス版)
• Claude Desktop

セットアップ

1. このリポジトリをクローンする：

   git clone https://github.com/yourusername/jeb-mcp-server.git
   cd jeb-mcp-server
   

2. Claude Desktopを設定する： Claude DesktopのMCP設定ファイルを編集します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json

   以下の設定を追加します。

   {
     "mcpServers": {
       "jeb-mcp-server": {
         "command": "python3",
         "args": ["/absolute/path/to/jeb-mcp-server/jeb_mcp_bridge.py"]
       }
     }
   }
   

3. JEBでスクリプトを読み込む：

   • JEB Decompilerを開きます。
   • 対象のAPKファイルを読み込みます。
   • スクリプトを実行します：File → Scripts → Run Script... → dJEB_mcp_server.pyを選択します。
   • サーバーがポート8851でリッスンを開始します。

4. Claude Desktopを再起動してMCPサーバーの設定を読み込む

💻 使用例

設定が完了すると、Claude Desktopを通じて自然言語でJEBと対話できます。サーバーは以下のツールを提供します。

利用可能なツール

基本的な使用法

1. ディープリンク分析

プロンプト：

このAndroidアプリケーションのディープリンク処理をステップバイステップで分析してください。
以下のことを行ってほしいです。
1. データスキームを持つインテントフィルターを処理するすべてのアクティビティを見つける
2. 各ディープリンクハンドラーについて、URL解析ロジックを追跡する
3. すべての可能なエンドポイントとそのパラメーターを抽出する
4. 分析やトラッキングコードは無視する
5. すべてのディープリンクエンドポイントとその機能の包括的なマップを作成する

徹底的に調査し、すべての関連クラスを探索してください。

2. インテリジェントなクラスリネーム

プロンプト：

難読化されたクラス "La/b/c;" とそのメソッドを意味のある名前にリネームしたいです。

以下のことを行ってください。
1. クラスをデコンパイルしてその目的を分析する
2. このクラスを参照する、または参照されるすべてのクラスを見つける
3. 以下を見ることで広いコンテキストを調べる：
   - 親クラスとインターフェース
   - そのメソッドを呼び出すクラス
   - その中でインスタンス化されるクラス
4. 以下に基づいて自信がある要素のみをリネームする：
   - メソッドの機能
   - 使用される文字列定数
   - Androidフレームワークのパターン
   - 一般的なデザインパターン
5. 説明付きのリネームマッピングを提供する
6. 一括リネーム操作を実行する

保守的に、確信がある要素のみをリネームしてください。

3. APIエンドポイント抽出

プロンプト：

このアプリケーションで使用されるすべてのREST APIエンドポイントを抽出してください。

以下のことを行ってください。
1. すべてのHTTPクライアントの使用（Retrofit、OkHttp、HttpURLConnectionなど）を見つける
2. APIインターフェース定義またはベースURL定数を見つける
3. 各エンドポイントについて、以下を抽出する：
   - HTTPメソッド（GET、POSTなど）
   - 完全なURLパス
   - リクエストパラメーター
   - レスポンスハンドリング
4. エンドポイントを機能/モジュールごとにグループ化する
5. サンプル付きのAPIドキュメントを作成する

実際のAPI呼び出しに焦点を当て、ロギングや分析は無視してください。

4. ブロードキャストレシーバー分析

プロンプト：

このアプリケーション内のすべてのブロードキャストレシーバーを分析してください。

各レシーバーについて：
1. どのインテントをリッスンしているかを特定する
2. 実行するアクションを説明する
3. エクスポートされているかどうかとそのセキュリティ上の影響を確認する
4. アプリ内でブロードキャストが送信される場所を見つける
5. 完全なブロードキャスト通信フローをマッピングする

エクスポートされたレシーバーに関するセキュリティ上の懸念事項を文書化してください。

5. 相互参照トレース

実行フローを追跡します。

"MainActivityのonCreateメソッドから始めて、ユーザーログインに関連するすべてのメソッド呼び出しを追跡し、関係するすべてのクラスを含む完全な認証フローをマッピングします。"

🤝 コントリビューション

コントリビューションを歓迎します！ 問題やプルリクエストを自由に送信してください。

開発

コードベースは以下で構成されています。

• Jythonコード (dJEB_mcp_server.py)：JEBのJython環境内で実行されます。
• Python 3コード (jeb_mcp_bridge.py)：標準のPython標準入出力ブリッジです。

コントリビュートする際には、JEBのJython 2.7環境との互換性を維持してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Model Context Protocol by Anthropicをベースに構築されています。
• JEB Decompiler by PNF Softwareと統合されています。
• AI支援のリバースエンジニアリングワークフローの必要性に触発されています。

🛠️ サポート

問題、質問、または機能要求については、GitHubで問題を開いてください。

⚠️ 重要提示

このツールは非公式のものであり、PNF SoftwareまたはAnthropicによって承認されたものではありません。