| name | ghidra-reverse |
| description | Ghidra 逆向分析辅助技能（GhydraMCP）。用户提到用 Ghidra 逆向、反编译、分析二进制/PE/ELF/APK/DLL/SO，
或明确不想用/没有 IDA License 想用免费方案时使用此技能。
Use when the user wants to reverse engineer, decompile, or analyze a binary with Ghidra specifically,
or as a free alternative when IDA Pro is unavailable.
⚠️ 本仓库尚未用真实项目验证过此技能，见下方"来源与验证状态"。有 IDA License 时优先用 `ida-reverse`
（已有本仓库真机验证的踩坑记录）；本技能用于 IDA 不可用、或用户明确要求 Ghidra 的场景。
|
Ghidra 逆向分析技能（GhydraMCP）
来源与验证状态（必读）
来源：GhydraMCP 官方文档/README（https://github.com/starsong-consulting/GhydraMCP），
本仓库尚未实战验证，遇到新坑请补充到此文件。
本文档基于 2026-07-11 对 GhydraMCP 仓库（starsong-consulting/GhydraMCP，276 star，Apache 2.0，未
归档）README 和源码（bridge_mcp_hydra.py）的核实整理。本仓库目前没有一次真实逆向任务跑过这套工具
链。不像 ida-reverse 的"已知问题与反思"来自真机踩坑，这里列的都是文档/源码推断出的"可能坑"，
请在第一次真实使用后回填本文件、补充真实踩坑记录。
这是什么
GhydraMCP（starsong-consulting/GhydraMCP）把 Ghidra 通过一个 HATEOAS REST API 插件 + Python MCP
桥接脚本（bridge_mcp_hydra.py）+ 独立 CLI（ghydra）暴露给 AI 助手。它 fork 自
LaurieWired/GhidraMCP，新增了多实例支持、数据操作能力和 HATEOAS REST API。支持 Ghidra 11.x 和
12.x（两个版本分开打包 release，插件 ghidraVersion 必须和实际 Ghidra 版本精确匹配）。
官方 README 把 MCP 桥接层标注为"deprecating in favor of CLI"—— 独立 CLI ghydra 是更新、更推荐
的用法（同等能力 + 更好的输出格式化 + --json 模式），但桥接脚本仍可用，是否切换不是本文档要决
定的事，先如实记录两条路径都存在。
端口配置存疑（请在首次真机验证时确认）
.kiro/settings/mcp.json 里已有这一条注册（此前完全没有文档说明，属于"已经接入但未被记录"的状态）：
"ghidra": {
"url": "http://localhost:8765/mcp"
}
kali/mcp-kali-example.json 也有对应条目（见该文件 ghidra 键）。但根据 GhydraMCP 官方 README
和 bridge_mcp_hydra.py 源码核实（2026-07-11 用 gh api 拉取 README 全文 + 用 GitHub code search
搜 8765/streamable 均零命中 + 直接 grep 源码得到下面两行）：
bridge_mcp_hydra.py:31: DEFAULT_GHIDRA_PORT = 8192
bridge_mcp_hydra.py:4261: mcp.run(transport="stdio")
也就是说：
- 官方桥接脚本固定走 stdio 传输，不是 HTTP/
url 形式的 MCP 端点
- Ghidra 插件本身监听的默认端口是 8192（第一个打开的 CodeBrowser 用 8192，后续每开一个递增，
多实例范围 8192-8447），不是 8765
- 官方文档/源码全文搜不到任何 "8765" 的引用
http://localhost:8765/mcp 这个配置，既不匹配 GhydraMCP 文档化的 Ghidra 实例端口范围（8192 起），
也不匹配它的 MCP 传输方式（stdio，不是 HTTP url）。可能的解释（未核实，按可能性排列）：
- 有人在这台机器上手动跑了一个自定义 HTTP wrapper，把 stdio 桥接转成 HTTP，监听在 8765
- 这条配置指向的其实是另一个同类 Ghidra-MCP 项目（不是
starsong-consulting/GhydraMCP）
- 这条配置是占位/未验证，从未真正连通过
首次真机验证此技能时，请先确认 .kiro/settings/mcp.json 里这条 ghidra 到底连的是什么进程；连
不通就改用下面的官方 stdio 配置。
标准配置（官方 README，stdio 方式）
{
"mcpServers": {
"ghydra": {
"command": "uv",
"args": ["run", "/ABSOLUTE_PATH_TO/bridge_mcp_hydra.py"],
"env": { "GHIDRA_HYDRA_HOST": "localhost" }
}
}
}
需要先从 GhydraMCP release 下载匹配 Ghidra 版本的 "Complete" 包（含插件 zip + bridge_mcp_hydra.py），
把插件通过 Ghidra File -> Install Extensions 装好、重启 Ghidra、在 File -> Configure -> Developer
里确认插件已启用，插件才会在 8192 起监听。官方确认兼容 Claude Desktop、Claude Code、Cline，均走
stdio 传输。
安装步骤（官方文档整理，未在本仓库实战跑过）
前置条件：
- Ghidra 11.x 或 12.x（release 按版本分开打包，插件
ghidraVersion 必须和实际 Ghidra 版本完全匹配）
- Java 21（构建插件需要，推荐 Temurin 21）
- Python 3 + MCP SDK（跑桥接脚本需要）
1. 下载最新 release: https://github.com/starsong-consulting/GhydraMCP/releases
2. Ghidra 里 File -> Install Extensions -> "+" -> 选匹配版本的 Ghydra-*-ghidra<version>.zip
3. 重启 Ghidra，File -> Configure -> Developer 确认插件已启用
4. 打开一个 CodeBrowser，从控制台日志确认实际监听端口（第一个实例通常是 8192，后续递增）
5. 把上面的 MCP 配置写入 Claude 的 MCP 配置文件，/ABSOLUTE_PATH_TO/ 换成实际 bridge_mcp_hydra.py 路径
6. 也可以完全不经过 MCP 客户端，直接用独立 CLI：pip install -e . 后 ghydra instances list
核心工具面（按命名空间整理自官方 README）
GhydraMCP 没有像 idapro_* 那样的单一共享前缀，工具按资源类型分组命名空间。以下分组是官方文档里
的整理，本仓库尚未连上真机确认 MCP 客户端里实际列出的工具名是否完全一致，真机连上后以实际列表
为准：
- 实例管理
instances_*：instances_list（先用这个，自动发现本机实例）、instances_discover、
instances_register、instances_unregister、instances_use、instances_current
- 函数分析
functions_*：functions_list、functions_get、functions_decompile
（style/syntax_tree/timeout 参数；反编译不完整时响应带 retry_recommended 建议）、
functions_disassemble、functions_create、functions_rename（new_name 带 :: 会移动命名
空间）、functions_set_signature、functions_delete、functions_get_variables、
functions_update_variable、functions_set_comment
- 数据操作
data_*：data_list、data_list_strings、data_create、data_rename、
data_delete、data_set_type（支持数组语法如 uint64_t[8]）
- 结构体
structs_*：structs_list、structs_get、structs_create、structs_add_field、
structs_update_field、structs_delete
- 内存
memory_*：memory_read（支持 hex/raw 格式，overlay-aware）、memory_write
- 交叉引用
xrefs_*：xrefs_list（to_addr/from_addr/type 过滤）
- 分析
analysis_*：analysis_run、analysis_status、analysis_get_callgraph、
analysis_get_dataflow
- 工程管理
project_*/projects_*/programs_*：project_info、project_list_files、
project_open_file、projects_list、projects_get、programs_list、programs_get、
programs_delete（⚠️ 官方文档标注这个和 program import 相关路由"可能返回 NOT_IMPLEMENTED，取决
于插件端支持情况"）
- 数据类型
datatypes_*：datatypes_list、datatypes_search、datatypes_create_struct、
datatypes_create_enum、datatypes_create_union
- 注释
comments_*：comments_set、comments_get
- UI 辅助
ui_*：ui_get_current_address、ui_get_current_function
- 元数据
classes_*/symbols_*/segments_*/namespaces_*/variables_*：列举类/符号/内存
段/命名空间/变量
典型工作流（官方 README Example Usage）：先 instances_list -> instances_use 选定实例 ->
functions_decompile 反编译关键函数 -> 需要时 structs_create/structs_add_field 建结构体 ->
xrefs_list/analysis_get_callgraph 做交叉引用和调用图 -> comments_set/functions_rename 记录
发现。命名空间用 :: 表示（如 MyClass::method），裸名字只在全局命名空间里解析 —— 和 IDA 的命
名习惯不完全一样，混着用容易找不到符号。
已知限制（来自官方文档，非本仓库实测）
- MCP 桥接层官方标注"deprecating in favor of CLI"，长期看应该优先学
ghydra CLI 而不是死磕桥接
- 反编译大函数超时默认较高：CLI/桥接 HTTP 超时 900 秒（
GHYDRA_TIMEOUT），反编译超时 1200 秒
（GHYDRA_DECOMP_TIMEOUT）；反编译不完整时响应会带重试建议，不要把长时间无响应当成卡死（和
ida-reverse 踩过的"带自动分析打开看起来像卡死"是同一类坑，值得留意）
programs_delete 和 program import 相关路由官方标注"可能返回 NOT_IMPLEMENTED"，取决于插件端版本- 插件
ghidraVersion 必须和实际安装的 Ghidra 版本精确匹配，装错版本会装不上（对应已关闭 issue
#26 "extension 装不上 Ghidra 12.0.4"，具体原因未展开）
- 官方仓库 open issue #27 是 "Support for Ghidra Server"（多人协作场景），说明当前工具面主要面向
单机单项目
- CLI 用法示例：
ghydra instances list、ghydra functions decompile --name main、
ghydra data list-strings --filter "password"、ghydra memory read --address 0x401000 --length 64、
ghydra --json functions list | jq '.result[].name'；常用 flag：--host、--port、--json、
--no-color
Prompt 工程准则（参照 ida-reverse，但降级为建议，未经本仓库验证）
- 和
ida-reverse 一样，先 instances_list/functions_list 做概况扫描，再针对性反编译，不要
一上来对整个二进制反编译
- 反编译/反汇编查询优先用函数名，找不到再退到地址
- 遇到超时优先怀疑是"分析还在跑"而不是"服务挂了"，参考上面的超时数值调大
timeout 参数
- 结构体/类型系统改动（
structs_*/datatypes_*）是有状态写操作，建议先 structs_get/
datatypes_search 确认目标不存在再创建，避免重复定义报错
- 多实例场景一定先
instances_current 确认当前工作实例，避免改错文件
路由上下文
上游入口: skills/SKILL.md（总控）、routing.md
上游备选: ida-reverse/（有 IDA License 时优先，已有本仓库真机验证的踩坑记录）；radare2/
（都不可用时的开源备选）
下游出口:
- 需要动态验证 ->
reverse-engineering/tools-dynamic.md
- 需要通用逆向方法论 ->
reverse-engineering/SKILL.md
同级关联模块: ida-reverse/（商业方案，已验证）、radare2/（另一个开源备选）
待办：首次真机验证后回填
