Ghidramcp

🚀 GhidraMCP

GhidraMCP是一個Ghidra插件，實現了模型上下文協議（MCP），可用於AI輔助的二進制分析。它能將Ghidra強大的逆向工程能力與AI助手相結合，讓二進制分析更高效、更易操作。

🚀 快速開始

Ghidra MCP通過模型上下文協議（MCP），彌合了Ghidra強大的逆向工程能力與AI助手之間的差距。該插件可使AI模型連接到Ghidra，協助完成二進制分析任務，讓逆向工程更加高效且易於開展。

✨ 主要特性

• AI驅動的二進制分析：通過模型上下文協議將AI助手連接到Ghidra
• 自然語言界面：用簡單的英語提出關於二進制文件的問題
• 深入的代碼洞察：檢索詳細的函數信息和反編譯代碼
• 二進制結構分析：探索導入、導出和內存佈局
• 自動化安全分析：獲取有關潛在安全漏洞的AI輔助見解
• 基於套接字的架構：Ghidra與AI助手之間的高性能通信
• 跨平臺兼容性：可在Ghidra支持的所有平臺上運行

📦 安裝指南

先決條件

• Ghidra 11.2.1+
• Java 17或更新版本
• Python 3.8+（用於橋接腳本）

步驟

1. 從發佈頁面下載最新的發佈ZIP文件
2. 打開Ghidra
3. 導航到文件 > 安裝擴展
4. 單擊“+”按鈕並選擇下載的ZIP文件
5. 重新啟動Ghidra以完成安裝
6. 通過轉到文件 > 配置 > 其他並選中“MCPServerPlugin”旁邊的框來啟用擴展

💻 使用示例

啟動MCP服務器

在啟用插件後打開Ghidra項目時，服務器會自動啟動。默認情況下，它在以下位置運行：

• 主機：localhost
• 端口：8765

您可以通過檢查Ghidra控制檯中的以下消息來驗證服務器是否正在運行：

MCP服務器已在端口8765上啟動

與AI助手連接

與Claude連接

要將Claude連接到GhidraMCP插件：

基礎用法

# 安裝MCP橋接腳本
pip install FastMCP

高級用法

# 將以下配置添加到您的Claude MCP設置中
{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": ["PATH-TO-REPO/GhidraMCP/ghidra_server.py"]
    }
  }
}

橋接腳本在Ghidra和Claude之間創建連接，通過自然語言實現即時二進制分析。

可用工具

該插件通過MCP界面公開了幾個強大的功能：

查詢示例

以下是您可以通過與MCP兼容的AI客戶端提出的問題示例：

• “此二進制文件中使用了哪些加密算法？”
• “您能向我展示地址為0x401000的函數的反編譯代碼嗎？”
• “此惡意軟件進行了哪些可疑的API調用？”
• “根據其導入和導出解釋此二進制文件的用途。”
• “此程序中的身份驗證機制如何工作？”
• “此代碼中是否存在任何潛在的緩衝區溢出漏洞？”
• “此二進制文件建立了哪些網絡連接？”
• “您能將此函數重命名為更具描述性的名稱嗎？”
• “向我顯示所有可能被利用的潛在用戶輸入源。”
• “為主函數生成調用圖。”

📚 詳細文檔

高級用法

安全分析功能

GhidraMCP為以安全為重點的分析提供了專門的工具：

• API調用序列分析：從函數中提取和分類外部API調用以進行安全分析。這有助於識別潛在的危險函數並瞭解它們的交互。
• 用戶輸入源：識別外部數據進入程序的入口點，這對於漏洞評估和了解攻擊面至關重要。
• 調用圖生成：創建結構化的調用圖以瞭解執行流程、跟蹤數據傳播並識別潛在的攻擊路徑。
• 加密模式檢測：識別加密實現，包括標準算法（AES、RSA等）和基於代碼模式的自定義實現。
• 混淆字符串檢測：查找可能通過XOR編碼或逐字符構造等技術混淆的字符串。

自定義配置

您可以通過編輯MCPServerPlugin.java文件來修改服務器端口：

server.setPort(YOUR_CUSTOM_PORT);

與分析工作流集成

GhidraMCP可以集成到您現有的分析工作流中：

1. 使用Ghidra的標準分析功能識別感興趣的區域
2. 通過GhidraMCP利用AI輔助以獲得更深入的理解
3. 將AI見解與您的手動分析相結合
4. 根據AI見解重命名函數和數據以提高可讀性

從源代碼構建

要從源代碼構建插件：

1. 克隆此存儲庫

git clone https://github.com/yourusername/GhidraMCP.git

2. 按照Ghidra開發人員指南中的說明設置Ghidra開發環境

3. 設置GHIDRA_INSTALL_DIR環境變量：

export GHIDRA_INSTALL_DIR=/path/to/ghidra

4. 使用Gradle構建：

./gradlew buildExtension

5. 擴展ZIP文件將在dist目錄中創建

故障排除

常見問題

• 連接問題：確保Ghidra實例正在運行並且插件已啟用
• 端口衝突：如果端口8765已被使用，請在插件配置中修改端口
• 橋接腳本錯誤：檢查是否已使用pip install FastMCP安裝了所有必需的Python軟件包
• 分析函數返回空結果：如果二進制文件不包含相關模式，某些安全分析函數可能會返回空結果

日誌

檢查以下日誌以進行故障排除：

• Ghidra控制檯中的服務器端消息
• ghidra_mcp_bridge.log中的橋接腳本問題

📄 許可證

貢獻

歡迎貢獻！請隨時提交問題或拉取請求。

1. Fork存儲庫
2. 創建您的功能分支：git checkout -b feature/amazing-feature
3. 提交您的更改：git commit -m 'Add some amazing feature'
4. 推送到分支：git push origin feature/amazing-feature
5. 打開一個拉取請求

致謝

• 美國國家安全局（NSA）開發了Ghidra
• 模型上下文協議社區
• 本項目的所有貢獻者

⚠️ 重要提示

GhidraMCP與NSA和Ghidra項目無關，也未得到其認可。