MCP 工具如何稳定接入

沿执行轨迹走

1. 每个 MCP 工具有两个名字

   每个 MCP 工具有两个名字：原始名只在线上出现，公开名是 mcp__服务器名__原始名，若改动名字就追加 12 位十六进制 hash。公开名是 (serverName, rawName) 的纯函数，连接顺序不影响改名。

   [repo]

2. 工具清单变化按世代同步

   工具清单变化按世代同步：先建好下一世代全部工具，失败不碰注册表；交换时先注销旧世代再注册新世代，冲突则整代回滚。断线时最后一个正常世代保持注册。

   [repo]

每一步改变了什么

• MCP 服务器重连时，工具清单怎样换代： 先完整构建下一世代，成功后再整体替换旧世代；构建失败不会留下半套新工具。

• 两个服务器都暴露 get_forecast 时为什么不会冲突： 公开名由服务器名与原始工具名共同决定，两套工具进入不同命名空间。

这条轨迹没有说明什么

• 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。