Ghidra MCP Zig

🚀 Ghidra MCP Zig 插件

Ghidra MCP Zig 插件是一個將 Ghidra 調試器與 Zig 編程語言相結合的綜合性項目。該插件通過提供函數反編譯、重命名等高級功能，有效增強了 Ghidra 的逆向工程和靜態分析能力。

🚀 快速開始

啟動 Ghidra 並打開待分析的程序，插件會出現在 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。

💻 使用示例

基礎用法

插件提供了一系列可用命令，以下是部分命令的使用說明：

• 反編譯函數：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 文件。