标签： MCP

当 MCP 工具的返回类型自引用（递归 BaseModel，以及 #3331 之后并入的递归 TypedDict）时，Pydantic 生成一个只含 $defs 和 $ref 、缺少根 "type": "object" 的 outputSchema。这与 2026-07-28 会话兼容，但在 202

当 MCP 客户端在 2025-11-25 协议会话上调用 tools/list 时，如果服务端某个工具的 inputSchema / outputSchema 的 properties 下出现布尔子 schema（如 {"result": true} ），Pydantic 会因 dict_type

在 mcp==2.1.0 中，通过高层 MCPServer API 注册的工具拿到的 Context 没有公开的 cancel_requested 事件，因此工具无法直接感知客户端取消；优先确认 SDK 版本，并改用 finally 或 CancelledError 做协作式清理。

当 MCP Python SDK 客户端在“尚未调用过 tools/list ”的会话里直接发起 tools/call ，而工具参数带有 x-mcp-header 注解时，客户端无法生成 Mcp-Param-* 请求头，服务端返回 -32020 （HeaderMismatch），旧版本客户端不会重新

在使用 MCP Python SDK 搭建授权服务器、开启 identity_assertion_enabled=True 并接入企业托管授权（ID-JAG）时，凡是使用 CIMD（Client ID Metadata Document）作为 client_id 、不带 client_secret