ghidra_MCP_logo

ghidraMCP

ghidraMCP は、LLM がアプリケーションを自律的にリバースエンジニアリングできるようにする Model Context Protocol サーバーです。Ghidra のコア機能から多数のツールを MCP クライアントに公開します。

https://github.com/user-attachments/assets/36080514-f227-44bd-af84-78e29ee1d7f9

特徴

MCP サーバー + Ghidra プラグイン

Ghidra でバイナリを逆コンパイルして解析
メソッドとデータを自動的に名前変更
メソッド、クラス、インポート、エクスポートを一覧表示

インストール

前提条件

Ghidra をインストール
Python3
MCP SDK

Ghidra

まず、このリポジトリから最新のリリースをダウンロードします。これには Ghidra プラグインと Python MCP クライアントが含まれています。その後、プラグインを Ghidra に直接インポートできます。

Ghidra を実行
File -> Install Extensions を選択
+ ボタンをクリック
ダウンロードしたリリースから GhidraMCP-1-2.zip（または選択したバージョン）を選択
Ghidra を再起動
File -> Configure -> Developer で GhidraMCPPlugin が有効になっていることを確認
オプション: Edit -> Tool Options -> GhidraMCP HTTP Server で Ghidra のポートを設定

ビデオによるインストールガイド:

https://github.com/user-attachments/assets/75f0c176-6da1-48dc-ad96-c182eb4648c3

MCP クライアント

理論上、どの MCP クライアントでも ghidraMCP と連携できるはずです。以下に 3 つの例を示します。

例 1: Claude Desktop

Claude Desktop を Ghidra MCP クライアントとして設定するには、Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json に移動し、以下を追加します:

{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

あるいは、このファイルを直接編集します:

/Users/YOUR_USER/Library/Application Support/Claude/claude_desktop_config.json

サーバーの IP とポートは設定可能で、対象の Ghidra インスタンスを指すように設定する必要があります。設定しない場合、どちらもデフォルトで localhost:8080 になります。

例 2: Cline

GhidraMCP を Cline で使用するには、MCP サーバーも手動で実行する必要があります。まず次のコマンドを実行します:

python bridge_mcp_ghidra.py --transport sse --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/

唯一の必須引数は transport です。他の引数が指定されていない場合は、すべて上記のデフォルト値になります。MCP サーバーが起動したら、Cline を開いて上部の MCP Servers を選択します。

Cline select

次に Remote Servers を選択して以下を追加します。URL が MCP ホストとポートに一致していることを確認してください:

サーバー名: GhidraMCP
サーバー URL: http://127.0.0.1:8081/sse

例 3: 5ire

バックエンドで複数のモデルをサポートするもう 1 つの MCP クライアントは 5ire です。GhidraMCP を設定するには、5ire を開いて Tools -> New に移動し、次の設定を行います:

ツールキー: ghidra
名前: GhidraMCP
コマンド: python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

ソースからのビルド

Ghidra ディレクトリからこのプロジェクトの lib/ ディレクトリに次のファイルをコピーします:

Ghidra/Features/Base/lib/Base.jar
Ghidra/Features/Decompiler/lib/Decompiler.jar
Ghidra/Framework/Docking/lib/Docking.jar
Ghidra/Framework/Generic/lib/Generic.jar
Ghidra/Framework/Project/lib/Project.jar
Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar
Ghidra/Framework/Utility/lib/Utility.jar
Ghidra/Framework/Gui/lib/Gui.jar

Maven で次のコマンドを実行してビルドします:

mvn clean package assembly:single

生成された zip ファイルには、ビルドされた Ghidra プラグインとそのリソースが含まれています。これらのファイルは、Ghidra が新しい拡張機能を認識するために必要です。

lib/GhidraMCP.jar
extensions.properties
Module.manifest

GhidraMCP

人気