
ghidra-mcp v6.0.0
GhidraのリバースエンジニアリングとAIツールを橋渡しするMCPサーバー:逆コンパイル、Pコードエミュレーション、ライブデバッグ、データフロー解析、バッチ操作、規約の適用をヘッドレスモードとGUIモードで提供する256のツール。
Ghidra MCP Server
このプロジェクトが役に立ったら、ぜひリポジトリに ⭐ スターを付けてください — 他の人が見つけやすくなります!
Ghidra MCP が時間の節約に役立っているなら、プロジェクトへのスポンサーをご検討ください。単発・継続どちらの支援も、互換性アップデート、本番環境向けの堅牢化、ドキュメント、新しいツールの開発資金に役立ちます。
Ghidra の強力なリバースエンジニアリング機能と、最新の AI ツールや自動化フレームワークを橋渡しする、本番環境対応の Model Context Protocol(MCP)サーバーです。219 個の MCP ツール、実戦で鍛え上げられた AI ワークフロー、そして利用可能な中で最も包括的な Ghidra-MCP 統合を提供します — 現在は P-code エミュレーション、ライブデバッガ統合、PCode グラフデータフロー解析も含みます。
クイックスタート: リリース版のインストール(クローン不要、ビルド不要)
各リリースには、必要な 2 つの
コンポーネントが含まれています: Ghidra 拡張機能(GhidraMCP-<version>.zip)と MCP
ブリッジ(ghidra_mcp_bridge-<version>-py3-none-any.whl)です。
-
前提条件をインストールする: Ghidra 12.2、 Java 25、そして uv です。 拡張機能は、ビルドされた正確な Ghidra バージョンでのみ読み込まれます。
-
拡張機能をインストールする: Ghidra のプロジェクトウィンドウで、File > Install Extensions を選択し、+ をクリックして、ダウンロードした
GhidraMCP-<version>.zipを選び、 Ghidra を再起動します。 -
プラグインを有効化する: プロジェクトウィンドウで、File > Configure > Utility > Configure を選択し、GhidraMCPPlugin にチェックを入れます。応答することを確認します:
curl http://127.0.0.1:8089/check_connection # {"status": "ok", "server_kind": "gui", "version": "7.0.0"} -
ブリッジをインストールする(同じリリースページからwheelのリンクをコピーしてください):
uv tool install https://github.com/bethington/ghidra-mcp/releases/download/v7.0.0/ghidra_mcp_bridge-7.0.0-py3-none-any.whl -
MCP クライアントをこのサーバーに向ける。絶対パスを使用する(
which bridge-mcp-ghidra、または Windows ではwhere.exe bridge-mcp-ghidra):{ "mcpServers": { "ghidra-mcp": { "command": "/home/<you>/.local/bin/bridge-mcp-ghidra" } } }Windows の場合:
"command": "C:\\Users\\<you>\\.local\\bin\\bridge-mcp-ghidra.exe"。 GUI やサービスから起動されたクライアントはシェルの PATH を参照しないため、 単にbridge-mcp-ghidraと指定するとspawn ENOENTで失敗します。
Ghidra でプログラムを開き、AI ツールに関数の一覧表示を依頼してください。手順 2〜3 のスクリーンショット: docs/INSTALL_GUI.md。ソースからのビルド、Docker、HTTP トランスポート、およびすべてのブリッジフラグについては、さらに下で説明します。
どのバージョンを実行すべきですか? タグ付きリリース (7.0.0、7.1.0、...) は安定版です。リリース候補と main はベータ版です: 機能は完成しており実環境でテスト済みですが、最終版の前に仕様が変わる可能性があります。dev は実験的です: ツールはそこで自由にマージ、名前変更、リファクタリングされるため、その API の上に何も構築しないでください。
なぜ Ghidra MCP なのか?
ほとんどの Ghidra MCP 実装は、いくつかの読み取り専用ツールを提供するだけで終わります。このプロジェクトは違います — デモとしてではなく、実際のバイナリに対して毎日使うリバースエンジニアによって作られました。
- 219 個の MCP ツール — 競合するどの実装よりも 3 倍多い。読み取り操作だけでなく、名前変更、型付け、コメント、構造体作成、スクリプト実行、P-code エミュレーション、ライブデバッグのための完全な書き込みアクセスを備えています。
- 実戦で鍛えられた AI ワークフロー — 数百の関数にわたって洗練された、実証済みのドキュメント作成ワークフロー (V5)。ステップバイステップのプロンプト、ハンガリアン記法のリファレンス、バッチ処理ガイド、孤立コードの発見を含みます。
- 本番品質の信頼性 — アトミックトランザクション、バッチ操作 (API 呼び出しを 93% 削減)、設定可能なタイムアウト、そして優雅なエラー処理。サイレント障害はありません。
- バイナリ間のドキュメント転送 — SHA-256 関数ハッシュマッチングにより、ドキュメントをバイナリのバージョン間で自動的に伝播します。一度ドキュメント化すれば、どこにでも適用できます。
- 完全な Ghidra Server 統合 — 共有 Ghidra サーバーへの接続、リポジトリ管理、バージョン管理、チェックアウト/チェックインのワークフロー、マルチユーザーコラボレーション。
- ヘッドレスモードと GUI モード — Ghidra GUI の有無にかかわらず実行可能。CI/CD パイプラインや大規模な自動分析向けに Docker 対応。
- 設計上のこだわり — v5.0 では、命名規則、型安全性、ドキュメント標準をツール層に移しました。AI エージェントと人間のエンジニアが、すべてのプロンプトにスタイルガイドを貼り付けることなく一貫した出力を生成します。
規約の強制
誰もが経験したことがあるでしょう: プロジェクトを始めて 6 か月後、同じコードベースに ProcessItem、process_items、handleItem、ItemProc を見つける — 同じことをする 4 つの関数が、共通の取り決めを持たない 4 つの異なるセッションやエンジニアによって命名されているのです。修正には必要以上に時間がかかり、問題はまた起こります。
v5.0 は、規約を「覚えておくべきこと」から、実際に強制できるツール層へと移します。
| 階層 | 動作 | 例 |
|---|---|---|
| 自動修正 | サイレントに適用 | uint32 上の count フィールド → 保存時に自動的に dwCount が付与される |
| 警告 | 変更は通るが、警告が返される | processData → 「名前は動詞を伴う PascalCase にすべきです: ProcessData」 |
| 拒否 | 変更が説明付きでブロックされる | undefined → undefined の型変更 → 「no-op は拒否されました、型は変更されていません」 |
AI エージェントにとって、これはすべてのセッション、すべてのモデル、すべての実行にわたって一貫した出力を意味します — すべてのプロンプトにスタイルガイドを貼り付ける必要はありません。ツールがルールを知っており、モデルはただ呼び出すだけでよいのです。
チームにとって、これは「それは私たちの命名規則ではない」というレビューコメントのカテゴリ全体を排除します。規約の裁定はコードレビューではなくツール内に留まります。
大規模なソロ作業にとって、analyze_function_completeness は 0〜100% のスコアを提供し、正直に測定します: 構造的な減点 (修正不可能なコンパイラのアーティファクト) は実効スコアでは免除され、対数スケーリングにより 1 つの悪いカテゴリが他を埋もれさせるのを防ぎ、段階的なプレートコメント品質により何が欠けているのか、その理由を正確に把握できます。
🌟 機能
コア MCP 統合
- 完全なMCP互換性 — Model Context Protocolの完全実装
- 219個のMCPツール — バイナリ解析のあらゆる側面をカバーする包括的なAPIサーフェス
- 本番環境対応の信頼性 — アトミックトランザクション、バッチ操作、設定可能なタイムアウト
- リアルタイム解析 — Ghidraの解析エンジンとのライブ統合
互換性に関する注意: MCPツール名はGitHub Copilot CLIおよびCAPI検証向けに正規化されています。公開されるツール名は小文字、数字、アンダースコア、ハイフンのみを使用します。
/debugger/statusのようなネストされたHTTPパスは、静的ブリッジツールとの衝突を避ける必要がある場合、debugger_status_2のような名前として公開されます。
バイナリ解析機能
- 関数解析 — デコンパイル、コールグラフ、クロスリファレンス、完全性スコアリング
- データフロー解析 — 任意の変数またはレジスタからのPCodeグラフによる値伝播(前方/後方)
- データ構造の探索 — フィールド解析と命名候補を伴うstruct/union/enumの作成
- 文字列抽出 — 正規表現検索、品質フィルタリング、文字列を起点とした関数探索
- インポート/エクスポート解析 — シンボルテーブル、外部ロケーション、序数インポートの解決
- メモリとデータの検査 — 生メモリの読み取り、バイトパターン検索、配列境界の検出
- バイナリ間ドキュメント — 関数ハッシュの照合とバージョン間のドキュメント伝播
動的解析 (v5.4.0)
- P-codeエミュレーション — Ghidraの
EmulatorHelperを介して任意の関数を単独で実行。APIハッシュ解決をミリ秒単位でブルートフォース - ライブデバッガ統合 — GhidraのTraceRmiフレームワークを介した16個の
/debugger/*エンドポイント(GUIプラグインのみ。Windows PEではdbgeng、それ以外ではgdb/lldb):起動、中断/再開、ステップイン/オーバー/アウト、ブレークポイント、レジスタ、メモリ読み取り、スタックトレース、ASLRを考慮した静的↔動的アドレス変換。ブリッジは22個のdebugger_*ツールを外部デバッガサーバーにプロキシすることも可能。これらはオプトインです(以下を参照)