GhidrAssistMCP控制面板指南:Host、端口与49个工具开关如何配置
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) |
📌 面板支持多 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;关闭后所有工具同步执行 |
几个关键行为值得注意:
- 自动重启:修改 Host、Port 或服务器启用状态后,保存时会自动重启 MCP 服务器使其生效,无需手动操作(逻辑见 GhidrAssistMCPManager.java)。
- async 开关:只影响后续请求的执行方式,不触发重启。异步任务可用
get_task_status查询结果、cancel_task取消。 - 配置持久化:点击 Save Configuration 后,设置写入 Ghidra 全局首选项与工具选项(默认值定义见 GhidrAssistMCPProvider.java),下次启动自动恢复。
- 无界面模式:如果通过
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 按钮可清空
常见问题排查
- 服务器无法启动:多半是端口被占用。检查 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。

