MCP stdio 传输的换行分隔 JSON 帧:工具结果里的换行如何让客户端解析错位
本地 MCP Server 通过 stdio 返回多行工具结果时,客户端常出现 JSON 解析失败或消息粘连。文章从规范对换行分隔帧的约束出发,分析服务端拼接原始文本、客户端按行切分的错位机制,并给出校验点、可观测指标与替代帧格式的取舍。
共 2 篇文章
本地 MCP Server 通过 stdio 返回多行工具结果时,客户端常出现 JSON 解析失败或消息粘连。文章从规范对换行分隔帧的约束出发,分析服务端拼接原始文本、客户端按行切分的错位机制,并给出校验点、可观测指标与替代帧格式的取舍。
本地 MCP Server 用 stdout 传 JSON-RPC、用 stderr 写日志时,客户端若不读取 stderr,管道缓冲区写满后服务端会阻塞在写日志调用上,工具调用随之无响应。本文从管道缓冲机制出发,解释阻塞的形成过程、日志级别与异步写入的缓解效果,并给出可观测指标和部署边界。