GhidraMCP

🚀 GhidraMCP 项目介绍

GhidraMCP 是一个基于模型上下文协议（Model Context Protocol，MCP）的工具，主要用于与 Ghidra 软件协同工作，为用户提供丰富的接口和功能，支持多种模型调用方式。

🚀 快速开始

GhidraMCP 是一个基于模型上下文协议（MCP）的工具，主要用于与 Ghidra 软件协同工作。以下将详细介绍该项目的功能、安装方法及相关使用示例。

✨ 主要特性

1. 功能强大：GhidraMCP 提供了丰富的接口和功能，支持多种模型调用方式。
2. 模块化设计：代码结构清晰，便于扩展和维护。
3. 文档完善：提供详细的使用说明和技术文档。

📦 安装指南

安装步骤

1. 下载并安装 Ghidra 软件（如果尚未安装）。
2. 将 GhidraMCP.jar 文件添加到 Ghidra 的扩展目录中。
3. 配置环境变量或直接运行项目脚本启动服务。

💻 使用示例

基础用法

示例 1：Claude Desktop

在 Claude Desktop 中使用 GhidraMCP：

1. 打开 Claude Desktop 并进入设置界面。
2. 添加新的 MCP 服务器，指定以下参数：
   • 工具密钥：ghidra
   • 名称：GhidraMCP
   • 命令：python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

示例 2：Cline

在 Cline 中使用 GhidraMCP：

1. 打开 Cline 并选择 MCP Servers。
2. 点击 Remote Servers，添加以下配置：
   • 服务器名称：GhidraMCP
   • 服务器 URL：http://127.0.0.1:8081/sse

示例 3：5ire

在 5ire 中使用 GhidraMCP：

1. 打开 5ire 并进入工具设置。
2. 点击 New，配置以下参数：
   • 工具密钥：ghidra
   • 名称：GhidraMCP
   • 命令：python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

高级用法

从源代码构建

1. 将 Ghidra 目录下的以下 JAR 文件复制到项目 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
   

2. 使用 Maven 打包：

   mvn clean package assembly:single
   

   打包完成后，生成的文件包括：
   • GhidraMCP.jar：Ghidra 插件
   • extensions.properties 和 Module.manifest：插件配置文件

📄 许可证

本项目采用 Apache 2.0 许可证，具体信息请参考 Apache License。

更多详细信息请参考项目文档或访问 GitHub 仓库。