GhidraMCP 安装与配置完整教程:从 Ghidra 插件启用到 MCP 客户端接入
【免费下载链接】GhidraMCPMCP Server for Ghidra项目地址: https://gitcode.com/gh_mirrors/gh/GhidraMCP
想让 AI 自己读二进制、自己反编译,而不是你一步步手动点选?GhidraMCP 安装与配置就为此而生:它把 Ghidra 的反编译、自动重命名、方法/类/导入导出列举等核心能力,通过 MCP 协议暴露给 LLM,让模型能自主驱动一次完整的逆向分析。这篇完整教程带你跑通 Ghidra 插件启用、端口设置与 MCP 客户端接入 Ghidra 的全流程。
GhidraMCP 环境搭建:安装前需要准备什么
开始配置前,先把下面三个组件备齐,缺一个都会让 GhidraMCP 无法启动。
| 组件 | 版本要求 | 作用 |
|---|---|---|
| Ghidra 逆向工程框架 | 官网最新版本 | 提供反编译、重命名、符号分析等核心能力,GhidraMCP 以插件形式挂在其上 |
| Python 运行环境 | 3.8 及以上 | 运行 MCP 客户端 / 服务端,桥接 Ghidra 与 LLM |
| Java 运行环境 | 与 Ghidra 配套版本 | Ghidra 启动并加载 GhidraMCP 插件所依赖的运行时 |
如果你后面要从源码构建插件包,还需额外准备 Maven,见文末“源码构建”一节。
Ghidra 插件启用教程:导入、勾选与端口配置
插件侧按“拿到包 → 导入并启用 → 设端口”一条线走完即可,全程几分钟。
- 拿到 GhidraMCP 插件包:两种方式二选一。克隆仓库后取发布包,或直接从仓库发布页下载预编译插件包
GhidraMCP-1-2.zip。克隆命令:git clone https://gitcode.com/gh_mirrors/gh/GhidraMCP - 导入并启用插件:启动 Ghidra,进入
File→Install Extensions,点+按钮,把上一步拿到的GhidraMCP-1-2.zip选进来,重启 Ghidra。重启后进入File→Configure→Developer,勾选GhidraMCPPlugin。
- 配置 HTTP 端口:进入
Edit→Tool Options→GhidraMCP HTTP Server,把端口设为 8080(默认值)。MCP 客户端稍后会指向这个端口,两边必须一致。
MCP 客户端接入 Ghidra:三种客户端怎么配
插件起好后,剩下就是让 MCP 客户端知道“怎么拉起 GhidraMCP、指向哪个 Ghidra”。下面按客户端拆开,各写差异点。
Claude Desktop 的 JSON 配置
Claude Desktop 走“桌面端 + JSON 配置文件”模式:由客户端自动拉起进程,改完保存、重启 Claude 即生效。打开Claude→Settings→Developer→Edit Config,编辑claude_desktop_config.json,加入下面这份配置(全文仅此一版完整 JSON,其余客户端复用同一结构):
{ "mcpServers": { "ghidraMCP": { "command": "python", "args": ["-m", "ghidraMCP.client"] } } }Cline 的 stdio 手动接入
Cline 不走托管拉起,需要你手动把服务跑起来,再在界面登记。先在终端执行:
python -m ghidraMCP.client stdio然后在 Cline 界面选择MCP Servers→Remote Servers,新增一项:服务器名称GhidraMCP、传输类型stdio、命令python、参数-m ghidraMCP.client。
5ire 的向导式新建
5ire 是多模型后端的 MCP 客户端,接入走向导而非改文件:5ire→Tools→New,名称填GhidraMCP,按向导逐项配置传输参数(命令与参数同 Cline 的 stdio 方式)。
客户端的 Python 实现位于 src/ghidra_mcp/ 目录,需要排查参数时可直接对照。
✅ GhidraMCP 连通性自检清单
配置完成后,按这份清单逐项打勾,全勾上才算真正接通:
- Ghidra 已加载一个可分析的二进制文件(如任意 ELF / PE 样本)
GhidraMCP HTTP Server已启动,默认监听 8080 端口- MCP 客户端已按上文配置,并成功拉起
ghidraMCP客户端 - 客户端能列出/调用 Ghidra 的方法、类、导入与导出
- 客户端指向的地址与 Ghidra 侧
Tool Options中设置的端口一致
🛠️ GhidraMCP 源码构建与常见排障
从源码构建 GhidraMCP.jar
需要改插件逻辑时,从源码构建。先把 Ghidra 安装目录下的以下 JAR 复制到项目lib/目录:
| JAR 文件 |
|---|
| Base.jar |
| Decompiler.jar |
| Docking.jar |
| Generic.jar |
| Project.jar |
| SoftwareModeling.jar |
| Utility.jar |
| Gui.jar |
再在项目根目录执行构建:
mvn clean package完成后生成GhidraMCP.jar,内含完整插件与资源。插件扩展源码在 [extension/](
【免费下载链接】GhidraMCPMCP Server for Ghidra项目地址: https://gitcode.com/gh_mirrors/gh/GhidraMCP
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考