Ghidra MCP

🚀 🔍 Ghidra MCP サーバー

このプロジェクトでは、Ghidra のヘッドレスモードを使用して、バイナリファイルから関数、疑似コード、構造体、列挙型などの豊富な逆コンパイルデータを抽出し、JSON ファイルに出力します。そして、Model Context Protocol (MCP) を通じて、Claude などの大規模言語モデルに提供します。

これにより、Ghidra を対話型の逆エンジニアリングバックエンドに変えることができます。

🚀 クイックスタート

このプロジェクトは、Ghidra のヘッドレスモードを活用し、バイナリファイルから逆コンパイルデータを抽出し、MCP を介して大規模言語モデルに提供することができます。以下に、その概要を説明します。

✨ 主な機能

• 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 によって開発されました。