wiblog
TAG

#MCP

共 36 篇文章

AI 技术
#MCP#JSON Schema#工具调用

MCP 工具参数默认值与必填校验：为什么 inputSchema 里省略的字段会让服务端收到 undefined

Agent 调用带可选参数的 MCP 工具时，模型省略字段常让服务端收到缺键参数对象，引发解引用报错或空值写入。文章从 JSON Schema 中 required 与 default 的语义边界出发，说明缺键如何产生、校验点应放在哪里，并比较客户端预填与服务端容错解析的取舍。

AI 技术
#MCP#JSON-RPC#批量请求

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

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

AI 技术
#MCP#JSON-RPC#错误处理

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

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

AI 技术
#MCP#stdio#JSON-RPC

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

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

AI 技术
#MCP#prompts/get#参数校验

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

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

AI 技术
#MCP#OAuth#RFC 9728

MCP 远程服务器的 OAuth 受保护资源元数据发现：客户端为何把授权请求发给错误的授权服务器

远程 MCP Server 接入第三方 OAuth 时，客户端常把授权请求发给错误的授权服务器。本文围绕 RFC 9728 受保护资源元数据、RFC 8414 授权服务器元数据、401 响应与 WWW-Authenticate 头，拆解资源标识暴露、resource 参数绑定、元数据缓存与路径拼接的失败机制，给出校验点与可观测指标。

AI 技术
#MCP#JSON Schema#工具调用

MCP 工具参数类型强制转换：为什么模型输出的字符串数字会让服务端校验失败

Agent 调用带数值与布尔参数的 MCP 工具时，模型常把 5 写成 "5"、把 true 写成 "true"，服务端按 inputSchema 严格校验就会直接拒绝。本文用一个库存查询工具贯穿全文，梳理类型声明、序列化路径、隐式转换歧义与枚举大小写问题，并对比客户端预校验与服务端宽松解析的取舍。

AI 技术
#MCP#JSON-RPC#幂等性

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

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

AI 技术
#MCP#JSON Schema#工具调用

MCP 工具输出校验：structuredContent 与 outputSchema 不一致时客户端为何解析失败

远程 MCP Server 返回结构化工具结果时，outputSchema 声明返回结构，structuredContent 承载实际负载。本文用一个订单查询工具贯穿全文，分析二者不一致、schema 未声明、客户端只读 content 文本分支时各自的解析失败路径，对比纯文本封装与严格校验两种方案，并给出服务端与客户端的校验点和可观测指标。

AI 技术
#MCP#Streamable HTTP#SSE

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

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

AI 技术
#MCP#Streamable HTTP#会话管理

MCP Streamable HTTP 的会话绑定：为什么窃取 Mcp-Session-Id 就能冒充客户端

远程 MCP Server 暴露在公网时，Mcp-Session-Id 只负责关联一次有状态会话，并不自动证明请求者是谁。文章解释会话 ID 与会话状态如何建立、为何可预测或未与访问令牌绑定，以及重连后不重新校验如何导致会话劫持，并对比无状态模式与每请求鉴权，给出绑定与轮换的可观测指标。

AI 技术
#MCP#OAuth 2.1#令牌受众

MCP 远程服务器的 OAuth 令牌受众校验：为什么为 A 服务签发的令牌能调用 B 服务

多台远程 MCP Server 共用同一授权服务器时，为 A 服务签发的访问令牌常能直接调用 B 服务。本文解释 RFC 8707 资源指示器与 aud 绑定机制，分析授权服务器未按资源签发、客户端复用令牌、资源服务器漏校验 aud 三类成因，对比静态 API Key 与逐服务令牌方案，并给出校验逻辑与可观测指标。

AI 技术
#MCP#Elicitation#JSON Schema

MCP Elicitation 中途索要参数：工具执行到一半如何安全地向人类追问

工具跑到一半才发现缺少必填参数，直接报错会让用户重来一遍。本文以订位工具为例，拆解 MCP elicitation/create 如何暂停调用、用受限 JSON Schema 收集结构化输入并恢复执行，分析 accept、decline、cancel 三条路径、schema 校验失败与超时处理、敏感字段为何必须走 URL 模式，并给出可观测指标与适用边界。

AI 技术
#MCP#资源订阅#缓存一致性

MCP 资源订阅与变更通知：客户端订阅后为何仍读到过期资源内容

远程 MCP Server 暴露文件与数据库资源时，客户端调用 resources/subscribe 后仍可能读到旧内容。文章拆解订阅、通知与缓存刷新的完整链路，分析订阅粒度粗、通知丢失、重连后订阅状态不同步等失效原因，并对比轮询与版本校验的取舍，给出可观测指标与部署边界。

AI 技术
#MCP#工具调用#缓存一致性

MCP 工具列表变更通知：服务端热更新后客户端为何仍在调用已删除的工具

远程 MCP Server 热更新工具后，客户端仍调用已删除工具，问题往往出在 tools/list_changed 通知链路而非服务端。本文拆解通知、重新拉取与缓存刷新的完整流程，分析通知丢失、未订阅、会话重连三类失效路径，对比轮询与版本校验方案，并给出可观测指标与部署边界。

AI 技术
#MCP#工具调用#上下文工程

MCP 工具定义注入如何挤占上下文：工具 schema 的 token 开销与按需加载机制

接入多个 MCP Server 的 Agent 为什么越接越笨？本文从工具名、描述与 JSON Schema 被序列化进系统提示并随每轮请求重复计费讲起，分析工具数量增长带来的上下文挤占与选择准确率下降，对比全量注入、检索式筛选与动态发现三种加载策略的延迟与可靠性权衡，并给出可观测指标与适用边界。