Ghidra MCP 7.0.0 工具整合迁移指南：272→251工具的破坏性变更全解析

Ghidra MCP 7.0.0 工具整合迁移指南272→251工具的破坏性变更全解析【免费下载链接】ghidra-mcpGhidra MCP Server — 200 MCP tools for AI-powered reverse engineering. GUI plugin headless server, lazy tool loading, convention enforcement, batch operations, Ghidra Server integration, and Docker deployment.项目地址: https://gitcode.com/gh_mirrors/ghi/ghidra-mcpGhidra MCP Server 是一个面向 AI 逆向工程的开源 MCP 服务器GUI 插件 无头服务器200 工具。它的7.0.0 大版本做了一次彻底的工具整合把冗余工具从272 个精简到 251 个删除全部旧接口、不留兼容别名属于典型的破坏性变更。本文带你用 10 分钟看懂这次变更的来龙去脉并给你一份可执行的迁移清单 ✅为什么 Ghidra MCP 7.0.0 要做工具整合在动手删工具之前项目先做了一轮完整的审计见 TOOL_AUDIT_AND_CONSOLIDATION.md结论有三文档与实现一致README 的 API 参考由 tests/endpoints.json 自动生成零缺失、零幽灵工具大量近重复set_plate_comment/set_decompiler_comment/set_disassembly_comment与统一的set_comment行为被验证完全相同batch_xxx系列与单数版互为冗余还挖出真 Bug如validate_data_type_exists对裸类型名int、DWORD全部误报不存在。整合原则只有一条一个工具搞定一个或一批one-or-many能力零删减——被删工具能做的每件事存活工具都能做。因为 7.0.0 就是破坏性边界所以采用干净切割不保留任何向后兼容别名。 为什么用大版本号7.0.0而不是补丁版因为语义化版本的主版本号正是为会弄坏你的场景准备的。团队曾考虑直接修订已发布的 6.0.0但那样会让同一个 tag 含义漂移读者无法分辨自己拉到的到底是哪个 6.0.0——详见 TOOL_AUDIT_AND_CONSOLIDATION.md 的 §5。4 大类整合21 个工具去哪儿了完整的旧工具 → 新工具 → 调用改写对照表在官方迁移契约 MIGRATION_7.0.0_TOOL_CONSOLIDATION.md 中共 23 条移除记录。下面按四类速览1️⃣ 注释类4 合 1CommentService被删除存活工具改写方式set_plate_commentset_commentset_comment(address, comment, typeplate)set_decompiler_commentset_commentset_comment(address, comment, typepre)set_disassembly_commentset_commentset_comment(address, comment, typeeol)get_plate_commentget_comment一次返回{plate, pre, eol, post}全部类型亮点set_comment/get_comment现在在任意地址上都有效旧工具仅限函数——数据全局变量的 plate 注释不再需要绕道batch_set_comments的 workaround。2️⃣ 单数/批量8 个 batch 工具并入可变参存活者batch_xxx家族被逐个吸收存活工具接一个也行接一批也行被删除存活工具批量形式batch_add_function_tagsadd_function_tag(assignments[...])batch_remove_function_tagsremove_function_tag(assignments[...])batch_create_labels/batch_delete_labelscreate_label/delete_label(labels[...])batch_decompiledecompile_function(functionsa,b,c)batch_analyze_completenessanalyze_function_completeness(addresses[...])rename_variablerename_variables(variable_renames[{old,new}])batch_set_variable_typesset_variables(variables[{name,type}])⚠️ 注意调用形态变化批量完整性打分从POST JSON 数组变成了GET 逗号分隔地址串调用方需要自己 join 地址列表。好处是批量打分从此跑在并发读路径上更快了。3️⃣ 真重复3 删 1 留被删除存活工具备注get_data_type_sizeget_type_size严格超集多出对齐 路径可直接替换validate_data_type_existsvalidate_data_typeaddress变可选顺带修复裸类型名解析 Bugrename_function_by_addressrename_functionold_name现在名字或地址都能传值得一提的是mcp_health被评估后保留了它返回连接池统计、运行时长、内存和活跃请求数和仅做存活探测的check_connection并不重复。4️⃣ 语义统一变量类型 符号重命名Tier-3set_variable_type新名见 FunctionService.java统一set_local_variable_type、set_parameter_type、set_decompiler_variable_type三者作用在反编译器高变量层本地变量和参数一次全覆盖。rename_symbol(target, new_name, kindauto)新名见 SymbolLabelService.java统一 5 个符号重命名工具kind ∈ {auto, data, global, label, external}。auto会自动识别符号类型需要rename_data那种严格命名质量拦截时请显式传kinddata。 随迁移一起修掉的 Bug整合顺带消灭了几个埋雷完整清单见 迁移契约 Bug fixes 一节BUG-1validate_data_type_exists对int、char *这类裸类型名全部返回exists: false——修复后复用get_type_size的解析器BUG-2create_struct会自动加匈牙利前缀b→cB但remove_struct_field只认变形后的名字。现在支持按原始词干回退匹配且create_struct会返回最终字段名NITget_function_labels现在接受地址此前只认函数名缺参时报Function not found: null。✅ 迁移清单如何确认自己已跟上 7.0.0仓库内部的所有调用点Python bridge、tools/setup/部署冒烟测试、ghidra_scripts/脚本、测试套件、运维文档已完成确定性重写。仓库外的 HTTP API 消费者需自行迁移步骤如下全局搜索旧工具名。23 个被删名字现在只应出现在历史文档CHANGELOG.md、docs/releases/和存活工具我替代了谁的描述里核对工具目录。权威计数永远以 tests/endpoints.json 为准本地可运行 test_published_counts.py——它会把 6 处对外公布的工具数字全部钉死任何漂移直接失败校验迁移表。test_migration_guide_successors.py 会逐条检查 23 条移除记录是否都有迁移路径验证存活路线注册。被删的手动路由batch_set_variable_types、get_data_type_size已从 ManualToolDescriptors.java 中剪除ManualToolDescriptorsParityTest会抓出任何有描述、无路由的残留部署后看/mcp/schema。确认存活工具数再跑集成测试层级pytest tests/ -m readonly、-m safe_write。 一个小彩蛋为什么发货目录是 253 而不是 251整合把公布面从 272 降到 251但同一版本周期里又新增了 2 个端点见 CHANGELOG.md v7.0.0 节/list_shadowed_globals— 找出被更大数据单元吞掉、在list_globals里结构性不可见的匿名类型全局变量/batch_get_comments—batch_set_comments的读侧对应物一次取回多地址的五类注释。所以最终目录是253 个工具GUI 插件提供 239、无头服务器 226、两者都有 212。想深入了解每个数字怎么来的直接看 tests/endpoints.json 即可。总结Ghidra MCP 7.0.0 的工具整合是一次能力不减、表面更干净的破坏性变更4 类 21 个净减少换来更少的近重复 schema模型不再需要在rename_data和rename_label之间猜、更简单的调用形态一个工具接一个或一批、以及 3 个顺手修好的解析 Bug。迁移的唯一成本是把旧工具名全局替换为存活者——官方对照表已备齐跟着 MIGRATION_7.0.0_TOOL_CONSOLIDATION.md 抄作业即可。 延伸阅读docs/project-management/ 目录下还有工具审计提案、响应契约等配套 RFCtests/conformance/ 则存放了全部 140 工具的合规性快照可作为行为基线参考。【免费下载链接】ghidra-mcpGhidra MCP Server — 200 MCP tools for AI-powered reverse engineering. GUI plugin headless server, lazy tool loading, convention enforcement, batch operations, Ghidra Server integration, and Docker deployment.项目地址: https://gitcode.com/gh_mirrors/ghi/ghidra-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考