GhidrAssistMCP控制面板指南:Host、端口与49个工具开关如何配置

原创2026-10-27 22:13:051,822 阅读

GhidrAssistMCP控制面板指南:Host、端口与49个工具开关如何配置

GhidrAssistMCP 是一款面向 Ghidra 的 MCP(Model Context Protocol)服务器扩展,安装后 AI 助手即可通过标准 API 调用 Ghidra 的反向工程能力。它的全部设置都集中在一个内置的控制面板里:本指南带你快速配置 Host 与 Port、启用/停用 MCP 服务器,并逐项管理 49 个内置工具的开关,按需定制你的 AI 逆向分析工作流。

打开控制面板:Window → GhidrAssistMCP

安装扩展并启用插件后(File → Configure → Configure Plugins 中搜索 "GhidrAssistMCP" 并勾选),有两种方式打开控制面板:

  • 菜单栏 Window → GhidrAssistMCP
  • 点击工具栏上的 GhidrAssistMCP 图标

面板由两个页签组成:

页签 作用
Configuration 配置 Host、Port、服务器开关,以及 49 个工具的启用状态
Log 实时显示每次 MCP 工具请求(REQ)与响应(RES)、会话事件(SESSION)

GhidrAssistMCP控制面板Configuration页:Host、端口设置与MCP工具开关列表

📌 面板支持多 CodeBrowser 窗口共享:整个 Ghidra 只运行一个 MCP 服务器实例,无论你在哪个窗口打开控制面板,看到和操作的都是同一个服务器(实现见 GhidrAssistMCPManager.java)。

Server Settings:Host、Port 与启用开关的配置方法

Configuration 页顶部的 Server Settings 区域包含 4 个配置项:

配置项 默认值 说明
Host localhost 服务器监听地址。AI 客户端(如 GhidrAssist)在本机时保持默认即可;跨机器访问时改为你机器的 IP
Port 8080 监听端口,有效范围 1–65535,必须与客户端填写的端口一致
Enable MCP Server 默认开启 勾选/取消即启动/停止 MCP 服务器
Enable async tool execution 默认开启 开启时,耗时较长的工具(反编译、结构分析等)异步执行并返回 task ID;关闭后所有工具同步执行

几个关键行为值得注意:

  1. 自动重启:修改 Host、Port 或服务器启用状态后,保存时会自动重启 MCP 服务器使其生效,无需手动操作(逻辑见 GhidrAssistMCPManager.java)。
  2. async 开关:只影响后续请求的执行方式,不触发重启。异步任务可用 get_task_status 查询结果、cancel_task 取消。
  3. 配置持久化:点击 Save Configuration 后,设置写入 Ghidra 全局首选项与工具选项(默认值定义见 GhidrAssistMCPProvider.java),下次启动自动恢复。
  4. 无界面模式:如果通过 analyzeHeadless 启动,则改用脚本参数配置,例如 host=127.0.0.1、port=8080(脚本见 GAMCPStartServerScript.java)。

49个工具开关:如何逐个启用与禁用

MCP Tools 表格列出了全部 49 个工具,每行三列:Enabled(复选框)、Tool Name、Description。只有第一列复选框可点击编辑,取消勾选即隐藏该工具,AI 客户端将无法发现并调用它。

安全敏感工具:默认已禁用

出于安全考虑,以下 3 个会触碰宿主机文件系统或执行脚本的工具默认处于禁用状态(见 GhidrAssistMCPBackend.java):

工具 风险原因
import_file 可读取宿主机文件并导入项目
scripts 可创建、删除并运行 Ghidra 脚本
export_program 可将二进制导出写入宿主机磁盘

确认需要时再在表格中手动勾选。其余 46 个工具(函数分析、反编译、重命名、结构操作、交叉引用等)默认全部启用。

保存后自动更新工具目录

工具发现目录是在服务器启动时构建的,因此只要工具开关发生变化,保存后 MCP 服务器会自动重启,Log 页签会记录 "Tool availability changed; restarting MCP server"。此外,工具栏上的 Refresh 按钮可随时刷新列表;每个工具的输入参数都会自动附加 program_name 字段,便于在多程序场景下精确指定目标。

Log 页签:实时监控工具请求与响应

Log 页签是排查问题的第一现场,每行带时间戳:

  • REQ: 工具名 {参数...} —— 客户端发起的调用
  • RES: 工具名 {结果...} —— 服务器返回的响应
  • SESSION: ... —— 服务器启动/停止、程序切换等会话事件
  • 超长内容自动截断至 60 字符;底部 Clear Log 按钮可清空

GhidrAssistMCP控制面板Log页:MCP工具请求与响应实时日志

常见问题排查

  • 服务器无法启动:多半是端口被占用。检查 8080 是否空闲,换一个端口并点击 Save Configuration。
  • 客户端连不上:先用 curl http://localhost:8080/sse 验证服务器;客户端可选的端点为 http://<host>:<port>/sse(SSE)、/message 和 /mcp(Streamable HTTP)。
  • 面板里没有工具:确认插件已在 Configure Plugins 中启用;Log 页签若显示 "Backend not available yet",等待初始化完成后再点 Refresh。
  • 想临时关闭服务器:取消勾选 Enable MCP Server 并保存即可,所有设置保持不变,重新勾选后恢复。

🔧 总结一下:日常只需关心 Host(一般保持 localhost)、Port(默认 8080)和 49 个工具开关;每次调整记得点击 Save Configuration。完整的功能与工具清单可参阅 README.md。

登录后查看全文
GhidrAssistMCP