Ghidra

🚀 GhidraMCP プラグインドキュメント

GhidraMCPは、Ghidraの機能を強化するプラグインです。これは、モデルコンテキストプロトコル（Model Context Protocol, MCP）を統合することで、バイナリ解析能力を向上させます。このプラグインは、AI支援分析、カスタム設定、深度セキュリティ検出などの豊富な機能を提供します。

✨ 主な機能

• AI支援分析：AIモデルを利用してバイナリファイルをスマートに解析します。
• カスタマイズ可能な設定：サーバーポートなどの核心パラメータを変更できます。
• 深度セキュリティ検出：複数のセキュリティホール検出メカニズムが組み込まれています。
• 拡張インターフェース：柔軟な二次開発インターフェースを提供します。

📦 インストール

リポジトリのクローン

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

環境設定

Ghidraのインストールパスを設定します。

export GHIDRA_INSTALL_DIR=/path/to/ghidra

コンパイルとビルド

Gradleを使用してコンパイルします。

./gradlew buildExtension

コンパイル後のプラグインファイルは dist ディレクトリに保存されます。

💻 使用例

プラグインの設定

MCPServerPlugin.java ファイル内のポート番号を変更します。

server.setPort(YOUR_CUSTOM_PORT);

機能の使用

1. Ghidraサービスを起動し、プラグインを読み込みます。
2. Ghidraの標準分析機能を使用して、対象領域を識別します。
3. AI支援分析を呼び出して、深い洞察を得ます。
4. 必要に応じて、関数や変数をリネームします。

基本的な使用法

// プラグインの基本的な設定
server.setPort(YOUR_CUSTOM_PORT);

高度な使用法

セキュリティ分析

• ユーザー入力検出：外部データのエントリポイントを識別し、ホール評価を容易にします。
• 呼び出しグラフ生成：プログラムの呼び出し関係グラフを構築し、実行フローを理解しやすくします。
• 暗号化モード識別：標準の暗号化アルゴリズムとカスタム実装を検出します。
• 反デバッグ文字列検出：隠されたり、混同された文字列がないかを検出します。

統合開発

1. Ghidraの分析機能を使用して、重要なコードセグメントを特定します。
2. プラグインのインターフェースを呼び出して、深い分析を行います。
3. AIの洞察を組み合わせて、分析結果を改善します。
4. 必要に応じて、関数や変数をリネームします。

🔧 トラブルシューティング

一般的な問題

• 接続問題：Ghidraサービスが起動し、プラグインが読み込まれていることを確認してください。
• ポート競合：8765ポートが使用中の場合は、プラグインの設定を変更してください。
• ブリッジスクリプトエラー：すべての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. Pull Requestを提出します。

🙏 謝辞

• NSA開発チーム：Ghidraプラットフォームを開発してくれました。
• MCPコミュニティ：モデルコンテキストプロトコルの発展を推進してくれました。
• すべてのプロジェクト貢献者

GhidraMCPは、NSAまたはGhidraチームとは関係ありません。