GhidrAssistMCP多程序支持指南:如何让AI同时分析多个二进制
GhidrAssistMCP多程序支持指南:如何让AI同时分析多个二进制
GhidrAssistMCP 是一款原生 Ghidra 扩展,内置 MCP(Model Context Protocol)服务器,让 AI 助手通过标准 API 调用 Ghidra 的反向工程能力。它的多程序支持(Multi-Program Support)允许你在同一会话中同时打开多个二进制文件,并通过 program_name 参数让 AI 精准指定要分析哪一个,非常适合对比分析、跨模块追踪等复杂场景。
为什么需要多程序支持?
逆向工程实战中经常需要同时打开多个目标:
- 对比两个版本的同一二进制(如旧版与新版的差异分析)
- 同时分析主程序和它依赖的库文件
- 在一个项目中批量处理多个样本
GhidrAssistMCP 采用单例共享服务器架构:一个 MCP 服务器(默认端口 8080)服务所有 CodeBrowser 窗口,并自动跟踪当前获得焦点的窗口。核心协调逻辑位于 GhidrAssistMCPManager.java。
第一步:用 list_binaries 发现所有已打开的程序
多程序工作流的第一站永远是 list_binaries 工具。它会列出所有 CodeBrowser 窗口中打开的程序,返回每个程序的名称、项目路径(Project Path)、可执行文件路径、格式、语言等信息,并标注当前激活的程序([ACTIVE])。
{
"method": "tools/call",
"params": {
"name": "list_binaries"
}
}
当项目中有多个程序时,list_binaries 会额外给出提示:使用列出的 Project Path 作为 program_name 参数来指定目标。工具实现见 ListProgramsTool.java。
第二步:用 program_name 精准指定目标程序
这是多程序支持的核心。GhidrAssistMCP 在注册工具时会自动为每个工具的输入 Schema 补充一个通用的 program_name 可选参数(见 GhidrAssistMCPBackend.java),因此你可以对任意工具显式指定目标:
{
"method": "tools/call",
"params": {
"name": "get_functions",
"arguments": {
"program_name": "/project/folder/target_binary.exe",
"limit": 10
}
}
}
程序名匹配规则
程序查找按以下优先级逐级放宽(实现见 GhidrAssistMCPManager.java):
| 优先级 | 匹配方式 | 适用场景 |
|---|---|---|
| 1 | 精确匹配项目路径 | 多个程序同名时区分,如 /v1/app.exe vs /v2/app.exe |
| 2 | 精确匹配程序名 | 常规指定 |
| 3 | 忽略大小写匹配 | 记不清大小写时 |
| 4 | 部分包含匹配 | 只记得名字片段时 |
💡 关键技巧:当项目中存在同名文件(例如不同文件夹下各有一个
app.exe),请务必使用list_binaries输出的 Project Path 作为program_name,避免歧义。
不指定时的默认行为
如果省略 program_name,工具会自动作用于当前激活窗口的程序——即你最近点击过的那个 CodeBrowser 窗口。这个"智能默认值"由焦点跟踪机制实现(GhidrAssistMCPManager.java),切换窗口时 AI 的目标程序也会自动跟随。
响应中的上下文提示:AI 如何避免"张冠李戴"
每次工具调用返回时,GhidrAssistMCP 都会附加一段上下文头,让 AI 明确知道自己操作了哪个二进制:
[Context] Operating on: lib.so | Active window: main.exe | Total open programs: 3
这样做的好处:
- 防止混淆:当操作目标与当前焦点窗口不一致时,AI 能立刻察觉
- 上下文感知:AI 始终知道用户正在查看哪个二进制
- 多任务友好:无需在每条指令里手动指定目标程序
实战技巧:批量分析与程序管理
一次分析所有已打开的程序
analyze_program 工具支持 scope: all_open 参数,对当前所有打开的程序执行 Auto Analysis,任务进度会按程序逐个汇报(实现见 AnalyzeProgramTool.java)。批量导入多个样本后,这是最省事的预热方式。
让 AI 帮你打开和关闭程序
除了直接操作 Ghidra 界面,还可以用以下工具在 AI 会话中管理程序:
| 工具 | 用途 |
|---|---|
open_program |
在项目列表中查找并打开程序,可选择静默分析提示 |
close_program |
关闭程序;有改动时需 save=true 或 ignore_changes=true |
project_files |
查看/删除项目中的文件和文件夹(删除需 confirm=true) |
Headless 模式下的多程序
如果你使用 analyzeHeadless 无界面启动,MCP 服务器通过预置脚本 GAMCPStartServerScript.java(见 ghidra_scripts/)启动,此时作用于当前加载的程序。适合 CI 流水线中批量分析样本。
常见问题排查
- AI 似乎在操作错误的程序:先调用
list_binaries确认[ACTIVE]标记,然后显式带上program_name - 同名程序找不到:使用
list_binaries返回的 Project Path(含文件夹路径)而非裸文件名 - 参数不生效:确认 MCP 客户端连接的是端口 8080 的服务器(SSE 端点
http://localhost:8080/sse)
更多细节可参考项目说明文档 README.md 中 "Multi-Program Support" 与 "Multi-Window Support" 章节。
小结
GhidrAssistMCP 的多程序支持让 AI 逆向工作流实现了质的飞跃:list_binaries 发现目标、program_name 精准定位、上下文提示防错、焦点跟踪提供智能默认值。掌握这套"发现 → 指定 → 验证"的节奏,你就能放心地让 AI 在同一会话中同时分析多个二进制文件了。