Djeb MCP Server

🚀 JEB MCP Server

JEB MCP Server 是一個模型上下文協議（MCP）服務器，它將 Claude Desktop 與用於 Android APK 分析的 JEB 反編譯器連接起來。這種集成使得能夠直接在 Claude 中實現由人工智能輔助的逆向工程工作流程。

✨ 主要特性

• 反編譯：將 DEX 中的方法和類反編譯為 Java 源代碼。
• 代碼導航：列出類、搜索資源並探索交叉引用。
• 批量重命名：批量重命名類、方法、字段和局部變量。
• 資源分析：訪問 AndroidManifest.xml、資源和資產文件。
• 交叉引用：查找方法、字段和字符串的所有引用。
• 類層次結構：探索類的實現和繼承關係。

🔧 技術細節

該系統由兩個組件組成：

1. JEB MCP 服務器（dJEB_mcp_server.py）：作為 Jython 腳本在 JEB 內部運行，通過套接字公開 JEB 的 API。
2. 橋接腳本（jeb_mcp_bridge.py）：通過標準輸入輸出將 Claude Desktop 連接到 JEB 服務器。

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

📦 安裝指南

前提條件

• JEB 反編譯器（許可版本）
• 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 反編譯器。
   • 加載目標 APK 文件。
   • 運行腳本：文件 → 腳本 → 運行腳本... → 選擇 dJEB_mcp_server.py。
   • 服務器將開始在端口 8851 上監聽。

4. 重啟 Claude Desktop 以加載 MCP 服務器配置。

💻 使用示例

基礎用法

配置完成後，你可以通過 Claude Desktop 使用自然語言與 JEB 進行交互。服務器提供以下工具：

高級用法

以下是一些可以與 JEB MCP Server 配合使用的強大提示：

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 文件。

🙏 致謝

• 基於 Anthropic 的 模型上下文協議 構建。
• 與 PNF Software 的 JEB 反編譯器 集成。
• 受人工智能輔助逆向工程工作流程需求的啟發。

🛠️ 支持

如果遇到問題、有疑問或有功能請求，請在 GitHub 上創建一個問題。

注意：這是一個非官方工具，與 PNF Software 或 Anthropic 沒有關聯或得到其認可。