标签： MCP

这是 MCP Python SDK v2 的 Streamable HTTP 客户端在解析单条 SSE 事件时的默认 1 MiB 大小上限导致的：只要服务端把大于 1 MiB 的 tools/call 或 tools/list 结果作为单个 data: 事件返回，HTTPX2 就抛 SSEError

这个报错通常出现在 Open WebUI 用 OAuth 2.1 接入 MCP Server、且 OAuth 授权服务器与 MCP Server 不在同一域名时。优先排查 Open WebUI 中填写的 MCP 连接地址是否写成了裸主机名，而不是完整的 /mcp 端点。

当 MCP Python SDK 的 FileResource 收到混合大小写或全大写的 text 媒体类型（如 Text/Markdown 、 TEXT/plain ）时，会被误判为二进制资源，导致文本内容以 bytes 返回。优先排查 MIME 类型比较是否做了大小写归一化。

当基于 MCP Python SDK 的服务器收到未知 JSON-RPC 方法调用时，会返回 -32602 Invalid params ，而 JSON-RPC 2.0 规范要求返回 Unknown methods return -32602 Invalid params instead of -3

当 Open WebUI 使用 native function calling（原生函数调用）时， search_web 以及 OpenAPI/MCP 工具服务器的返回结果不会生成引用来源（source chips），即使搜索结果里已经包含 title/link/snippet。根因是 utils/