https://www.xlabs.club/tags/stdio/Recent content in Stdio on XLabsHugozh-CNCopyright (c) 2020-2025 XLabs ClubFri, 09 Oct 2026 00:09:30 +0800https://www.xlabs.club/blog/mcp-tool-result-limits/Fri, 09 Oct 2026 00:00:00 +0800https://www.xlabs.club/blog/mcp-tool-result-limits/<p>上一篇 <a href="https://www.xlabs.club/blog/mcp-2026-07-28-deprecation-sdk-lag/">MCP 2026-07-28 弃用扫描</a> 我 grep 的是 SDK 有没有跟上 spec。这篇 grep 另一件事：<strong>我 server 返回的工具结果，在客户端那边会经历什么</strong>。</p> <p>四条结论都不在文档里，也不在类型定义里，跑出来才知道：</p> <ul> <li>stdio 下，结果帧超过 <strong>10,485,760 字节</strong> 就断连，调用方只看到 <code>MCP error -32000: Connection closed</code>，真实原因只在 <code>transport.onerror</code> 里。</li> <li>这个上限属于<strong>读的一方</strong>（客户端）。服务端把 <code>maxBufferSize</code> 调多大都没用。</li> <li>服务端 <code>outputSchema</code> 校验失败变成一个 <code>isError: true</code> 的<strong>正常 result</strong>，不是 JSON-RPC error，<code>try/catch</code> 抓不到。</li> <li>客户端只在调过 <code>tools/list</code> 之后才校验 <code>structuredContent</code>；而且 <code>isError: true</code> 时它照校验不误，会把错误结果整个抛成异常。</li> </ul> <h2 id="环境">环境</h2> <ul> <li><code>@modelcontextprotocol/sdk@1.32.1</code>（npm 当前 latest）+ <code>zod</code></li> <li>Node v26.3.0，stdio transport，全部默认配置</li> <li>每个用例开新客户端进程，避免上一轮的断连污染下一轮</li> <li>单文件复现脚本在文末，<code>node mcp-result-limits.mjs</code> 直接跑</li> </ul> <h2 id="一outputschema校验失败不是错误">一、outputSchema：校验失败不是错误</h2> <p>工具声明 <code>outputSchema: { count: z.number() }</code>，handler 返回 <code>{ count: 'one' }</code>。服务端 <code>McpServer</code> 确实拦了，但拦下来的处理方式是这样：</p>