Ghidra MCP Zig

🚀 Ghidra MCP Zig プラグイン

Ghidra MCP Zig プラグインは、Ghidra デバッガと Zig プログラミング言語を組み合わせた総合的なプロジェクトです。このプラグインは、関数の逆コンパイル、名前の変更、その他の高度な機能を提供することで、Ghidra の逆エンジニアリングと静的解析能力を強化することを目的としています。

🚀 クイックスタート

このプラグインを使用することで、Ghidra の逆エンジニアリング機能を拡張できます。以下の手順に従って、プラグインをインストールして使用してください。

✨ 主な機能

• JNI 橋接：Zig と Java の間の通信を実現します。
• 分析ロジック：関数の逆コンパイルや名前の変更などの核心機能を処理します。
• サーバ実装：リモートコマンド実行インターフェースを提供します。

📦 インストール

インストール依存ソフトウェア

以下のソフトウェアをインストールしてください：

• Zig プログラミング言語
• Ghidra デバッガ
• JDK 17
• CMake

CMakeLists.txt で混合エクスポートを有効にして、異なるプラットフォームとの互換性を確保します：

set(CMAKE_MIXED_EXPORTS TRUE)

インストール手順

1. プラグインをコンパイルします：

   make build-plugin
   

2. 生成されたプラグインを Ghidra のプラグインディレクトリにコピーします：

   cp zig-out/lib/libghidra-mcp-zig.dylib /path/to/ghidra/Extensions/Ghidra/ghidra-mcp-zig/
   

3. Ghidra を再起動します。

💻 使用例

基本的な使用法

1. Ghidra を起動し、分析対象のプログラムを開きます。
2. プラグインは Ghidra のプラグインマネージャに表示されます。
3. Ghidra のインターフェースを通じてプラグインの機能を使用します。

利用可能なコマンド

• 関数の逆コンパイル：decompile
• 関数の名前変更：rename_function
• データの名前変更：rename_data
• すべての関数をリストする：list_functions
• すべてのデータをリストする：list_data
• インポートをリストする：list_imports
• エクスポートをリストする：list_exports

📚 ドキュメント

エラー処理

プラグインは、デバッグを支援するためにさまざまなエラータイプを提供します：

• ConnectionError：接続関連の問題。
• MessageError：メッセージ処理エラー。
• ResponseError：レスポンス解析失敗。

開発とデバッグ

1. JNI 橋接の実装を更新する場合は：

   src/plugin/jni/bridge.zig
   

2. 対応する機能を実装する場合は：

   src/plugin/analysis.zig
   

3. サーバロジックを更新する場合は：

   src/server/main.zig
   

コントリビューションガイド

1. このプロジェクトを Fork します。
2. 新しい機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. Pull Request を提出します。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。詳細は LICENSE ファイルを参照してください。