Ghidra MCP

🚀 🔍 Ghidra MCP 服務器

本項目支持藉助 Ghidra 的無頭模式，從二進制文件裡提取豐富的反編譯數據（如函數、偽代碼、結構體、枚舉等），並將其輸出為 JSON 文件。同時，通過 Model Context Protocol (MCP) 把這些數據提供給像 Claude 這樣的大語言模型。它成功將 Ghidra 轉變為一個交互式的逆向工程後端。

🚀 快速開始

本項目可讓你使用 Ghidra 的無頭模式，從二進制文件中提取反編譯數據，輸出到 JSON 文件，並通過 MCP 提供給大語言模型，將 Ghidra 變成交互式逆向工程後端。

✨ 主要特性

• 運用 Ghidra 無頭模式對二進制文件進行反編譯。
• 能夠提取以下內容：
  • 函數偽代碼、名稱、參數、變量、字符串以及註釋。
  • 數據結構（結構體）、枚舉和函數定義。
• 將提取結果輸出到 ghidra_context.json 文件。
• MCP 服務器提供如下工具：
  • list_functions()，get_pseudocode(name)
  • list_structures()，get_structure(name)
  • list_enums()，get_enum(name)
  • list_function_definitions()，get_function_definition(name)

📦 安裝指南

⚙️ 系統要求

• macOS（已測試）
• Python 3.10+
• Ghidra 11.3.1+
• Java 21（推薦使用 Temurin）
• MCP 客戶端（例如 Claude Desktop）
• mcp CLI（通過 pip install mcp 安裝）

🧪 安裝與設置

✅ 1. 安裝 Java 21（Ghidra 11.3.1 的必需項）

brew install --cask temurin@21

然後進行配置：

export JAVA_HOME=$(/usr/libexec/java_home -v 21)
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 21)' >> ~/.zshrc
source ~/.zshrc

檢查安裝情況：

java -version

應該顯示：openjdk 版本 "21.0.x"...

✅ 2. 安裝 Ghidra

下載並解壓 Ghidra 11.3.1。

✅ 3. 安裝 Python 和依賴項

安裝 Python 3.10+ 並通過 pip 安裝以下依賴項：

pip install mcp-server requests

📚 詳細文檔

📂 項目結構

👨‍💻 作者

Tomi Bamimore
Ghidra 由美國國家安全局開發
MCP 由 Anthropic 開發