MCP 的 JSON-RPC 批量请求:响应乱序时客户端为何会配对错乱
批量发送 MCP 请求时,服务端可以并发处理并按任意顺序返回响应。本文从一次并行读取多个资源的客户端场景出发,解释 JSON-RPC 2.0 的 id 配对规则、服务端并发导致乱序的机制、id 重复或缺失时错配的具体表现,并给出校验点、可观测指标与逐条请求方案的取舍。
共 10 篇文章
批量发送 MCP 请求时,服务端可以并发处理并按任意顺序返回响应。本文从一次并行读取多个资源的客户端场景出发,解释 JSON-RPC 2.0 的 id 配对规则、服务端并发导致乱序的机制、id 重复或缺失时错配的具体表现,并给出校验点、可观测指标与逐条请求方案的取舍。
远程 MCP Server 执行查询工具时,把参数校验失败、业务空结果和传输异常都塞进 isError 或 content 文本,会让客户端与模型无法区分可重试与不可重试。本文拆解 CallToolResult 中 isError 的定位、错误分类混用的失效机制,对比结构化错误码方案,并给出校验点与可观测指标。
本地 MCP Server 通过 stdio 返回多行工具结果时,客户端常出现 JSON 解析失败或消息粘连。文章从规范对换行分隔帧的约束出发,分析服务端拼接原始文本、客户端按行切分的错位机制,并给出校验点、可观测指标与替代帧格式的取舍。
本地 MCP Server 用 stdout 传 JSON-RPC、用 stderr 写日志时,客户端若不读取 stderr,管道缓冲区写满后服务端会阻塞在写日志调用上,工具调用随之无响应。本文从管道缓冲机制出发,解释阻塞的形成过程、日志级别与异步写入的缓解效果,并给出可观测指标和部署边界。
远程 MCP Server 暴露带必填参数的提示模板时,客户端常因参数名大小写、缺失或类型不符收到 -32602 错误。本文沿 prompts/list 的 arguments 声明到 prompts/get 校验链路,解释服务端如何判定参数合法,对比客户端预校验与服务端宽松解析的取舍,并给出可观测指标与部署边界。
远程 MCP Server 注册的工具超过一页时,tools/list 会返回 nextCursor,客户端必须带着游标继续拉取才能拿到完整工具集。本文解释分页契约、客户端漏跟游标和服务端游标失效这两类故障,并给出校验点与可观测指标。
以远程 MCP Server 启动握手为场景,说明 initialize 请求中 capabilities 如何声明双方支持的采样、通知与根目录能力,分析客户端漏报 sampling 或 roots 后服务端调用被拒或降级的机制,并给出可观测指标与兼容性边界。
远程 MCP Server 执行下单类写工具时,客户端超时重发同一 JSON-RPC 请求,服务端却把它当成一次新调用,导致重复扣款或重复下单。本文从 JSON-RPC 请求 ID 的会话内语义出发,解释断线重连后 ID 重置、服务端缺少幂等键存储的机制,并对比幂等键、去重窗口与人工确认三种方案,给出可观测指标与部署边界。
远程 MCP Server 排障时,服务端明明调高了日志级别,客户端却只看到 info 以上日志。文章从 logging/setLevel 与 notifications/message 的职责划分入手,解释级别未同步、通知未订阅、会话重连后级别重置三类日志缺失,并对比本地日志与轮询方案的取舍。
远程 MCP Server 返回单次工具结果时,服务端可以直接用 application/json 响应,而不必开启 SSE 流。这篇文章解释规范允许的两种响应形态、客户端对 Content-Type 的解析假设、请求与响应的配对方式,以及 JSON 单次响应与 SSE 流式响应在兼容性、可观测性和失败模式上的差异。