快速结论:该报错通常出现在使用 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 版本,防止升级被其他依赖限制。
解决步骤
- 升级 MCP Python SDK 到 2.0.0(该版本已由维护者确认修复,`DiscoverResult` 不再包含顶层 `serverInfo`)。
- 若仍需兼容旧版本,可优先检查 server 端是否已按新规范在 `_meta` 中返回 `serverInfo`;但 Issue 中未提供旧版本兼容方案,此步仅为排查方向。
- 如升级后仍出现此报错,检查是否使用了非官方的 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
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

![[Question]: Getting all 0 vector similarity in retrieval testing by adding a reranker model](https://www.chat-gpts.plus/wp-content/uploads/2026/08/9388-f8d94761-768x403.jpg)
