TAG

#JSON-RPC

共 10 篇文章

MCP 的 JSON-RPC 批量请求:响应乱序时客户端为何会配对错乱

批量发送 MCP 请求时,服务端可以并发处理并按任意顺序返回响应。本文从一次并行读取多个资源的客户端场景出发,解释 JSON-RPC 2.0 的 id 配对规则、服务端并发导致乱序的机制、id 重复或缺失时错配的具体表现,并给出校验点、可观测指标与逐条请求方案的取舍。

MCP 工具结果的 isError 语义:业务失败与协议错误混用为何让 Agent 误判重试

远程 MCP Server 执行查询工具时,把参数校验失败、业务空结果和传输异常都塞进 isError 或 content 文本,会让客户端与模型无法区分可重试与不可重试。本文拆解 CallToolResult 中 isError 的定位、错误分类混用的失效机制,对比结构化错误码方案,并给出校验点与可观测指标。

MCP stdio 传输的 stderr 阻塞:服务端写满标准错误缓冲区为何让工具调用挂起

本地 MCP Server 用 stdout 传 JSON-RPC、用 stderr 写日志时,客户端若不读取 stderr,管道缓冲区写满后服务端会阻塞在写日志调用上,工具调用随之无响应。本文从管道缓冲机制出发,解释阻塞的形成过程、日志级别与异步写入的缓解效果,并给出可观测指标和部署边界。

MCP 提示模板参数校验:为什么客户端按 prompts/get 传入的参数会被服务端拒绝

远程 MCP Server 暴露带必填参数的提示模板时,客户端常因参数名大小写、缺失或类型不符收到 -32602 错误。本文沿 prompts/list 的 arguments 声明到 prompts/get 校验链路,解释服务端如何判定参数合法,对比客户端预校验与服务端宽松解析的取舍,并给出可观测指标与部署边界。

MCP 工具调用超时重试:客户端重发请求为何导致写操作重复执行

远程 MCP Server 执行下单类写工具时,客户端超时重发同一 JSON-RPC 请求,服务端却把它当成一次新调用,导致重复扣款或重复下单。本文从 JSON-RPC 请求 ID 的会话内语义出发,解释断线重连后 ID 重置、服务端缺少幂等键存储的机制,并对比幂等键、去重窗口与人工确认三种方案,给出可观测指标与部署边界。

MCP Streamable HTTP 的 JSON 响应模式:服务端不返回 SSE 流时,工具结果为何会丢失

远程 MCP Server 返回单次工具结果时,服务端可以直接用 application/json 响应,而不必开启 SSE 流。这篇文章解释规范允许的两种响应形态、客户端对 Content-Type 的解析假设、请求与响应的配对方式,以及 JSON 单次响应与 SSE 流式响应在兼容性、可观测性和失败模式上的差异。