GhidrAssistMCP多程序支持指南:如何让AI同时分析多个二进制

原创2026-10-27 19:45:331,921 阅读

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 在同一会话中同时分析多个二进制文件了。

登录后查看全文
GhidrAssistMCP