serverInfo should be within Meta instead of serverDiscover result

该报错通常出现在使用 MCP Python SDK v2 进行 server discovery(查找/发现服务器)时,服务器返回的 `serverInfo` 字段位置不符合新版 MCP 规范(应从 `serverDiscover result` 顶层移至 `_meta` 内)。优先排查你是否使用了

快速结论:该报错通常出现在使用 MCP Python SDK v2 进行 server discovery(查找/发现服务器)时,服务器返回的 `serverInfo` 字段位置不符合新版 MCP 规范(应从 `serverDiscover result` 顶层移至 `_meta` 内)。优先排查你是否使用了 2026-07-28 之后的 v2 最新版本,并确认是否已升级到 `mcp` 2.0.0。

适用环境:MCP Python SDK v2(2026-07-28 版本,含 `serverDiscover` 相关逻辑);不涉及具体操作系统、Python、CUDA、显卡或依赖环境,Issue 中未提供这些信息。

最快修复方案:直接升级到 `mcp` 2.0.0(该版本已修复此问题)。Issue 中确认修复已在 #3143 合并并随 2.0.0 发布。

注意事项:若无法立即升级,需注意此修复涉及更深层的代码变动(不只是 schema 修改,还需调整 stamping 逻辑),不建议自行局部修改 schema 绕过。

问题场景

用户在使用 MCP Python SDK v2(2026-07-28 版本)进行 server discovery 时发现:MCP 规范已在 modelcontextprotocol/modelcontextprotocol#3002 更新,要求把 `serverInfo` 移入 `_meta` 字段,但 Python SDK v2 尚未同步该变更,导致 `DiscoverResult` 中 `serverInfo` 的位置与最新规范不一致,触发报错 serverInfo should be within Meta instead of serverDiscover result

报错原文

serverInfo should be within Meta instead of serverDiscover result

原因分析

这是 明确原因:MCP 官方 schema 已更新,`serverInfo` 从 `DiscoverResult` 顶层移除,改为由服务器在每次结果的 `_meta` 中打上 `io.modelcontextprotocol/serverInfo` 标记。Python SDK v2(2026-07-28 版本)尚未跟进此规范变更,因此客户端仍从 `serverDiscover result` 顶层读取 `serverInfo`,与最新规范不兼容。

修复者评论指出:此问题比单纯改 schema 复杂,因为需要修改整个代码库中的 stamping(打戳/标记)逻辑。

环境排查

  • 确认 MCP Python SDK 版本是否在 v2 latest(2026-07-28 之后)之前——此版本确认存在该问题。
  • 确认是否已升级到 `mcp` 2.0.0(修复版本)。
  • 检查项目依赖中是否显式锁定了 Python SDK 版本,防止升级被其他依赖限制。

解决步骤

  1. 升级 MCP Python SDK 到 2.0.0(该版本已由维护者确认修复,`DiscoverResult` 不再包含顶层 `serverInfo`)。
  2. 若仍需兼容旧版本,可优先检查 server 端是否已按新规范在 `_meta` 中返回 `serverInfo`;但 Issue 中未提供旧版本兼容方案,此步仅为排查方向。
  3. 如升级后仍出现此报错,检查是否使用了非官方的 server 实现,对方可能仍未按新规范输出 `serverInfo`。

验证方法

升级到 `mcp` 2.0.0 后,重新运行 server discovery 操作,确认不再触发 serverInfo should be within Meta instead of serverDiscover result 错误,并确认通过 Client.server_info 可以正常从 _meta 中读取到服务器信息。

参考来源

modelcontextprotocol/python-sdk #3144

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 18791

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注