掘金· Dumbness·· 5 小时前精选AI 评分36
开发者复盘 MCP 服务器 stdio 传输踩坑：不带换行的 stdout 日志会让客户端超时
写 MCP 服务器踩的坑：stdout 是协议通道，一行不带换行的日志就能让客户端超时
AI 导读
作者用 Node 20.19.2、@modelcontextprotocol/sdk 1.32.1 和 zod 4.6.7 写了离线 MCP 服务器 cn-dev-mcp，内含 13 个国内开发小工具，走 stdio 供 Cursor、Claude Code 等客户端使用。
推荐理由
作者用自己写的 MCP 服务器实测了 stdout 污染导致客户端超时的完整链路，适合正在做 MCP 工具的开发者避坑。
来源：掘金 · juejin.cn