[Bug] Failed to retrieve the Manifest via MCP Streamable HTTP: supergateway is incompatible with the client protocolVersion

[zzwtsy]

Contact Information

No response

1Panel Version

v2.2.1

Problem Description

在 1Panel 中部署 shadcn MCP 服务时，将 stdio MCP server 暴露为 Streamable HTTP endpoint。服务可以正常启动，endpoint 也收到了 MCP initialize 请求，但客户端获取 Manifest 失败。

客户端报错：

获取 Manifest 失败: Streamable HTTP error: Error POSTing to endpoint: {"jsonrpc":"2.0","error":{"code":-32000,"message":"Bad Request: Unsupported protocol version (supported versions: 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07)"},"id"}

从日志看，客户端发送的 protocolVersion 是 2025-11-25，但当前 supergateway 支持的协议版本最高只到 2025-06-18，因此疑似 1Panel 当前 MCP 应用模板或默认使用的 supergateway 镜像与新版 MCP 客户端协议不兼容。

Steps to Reproduce

1. 在 1Panel 中创建 shadcn MCP 服务, 配置如下

   

2. 使用 LobeHub MCP Client 或其他支持 Streamable HTTP 的 MCP 客户端连接该 endpoint。

3. 客户端尝试获取 Manifest 时失败，并提示 Unsupported protocol version。

The expected correct result

No response

Related log output

shadcn  | Node.js v20.19.5
shadcn  | [supergateway] Starting...
shadcn  | [supergateway] Supergateway is supported by Supermachine (hosted MCPs) - https://supermachine.ai
shadcn  | [supergateway]   - outputTransport: streamableHttp
shadcn  | [supergateway] Running stateless server
shadcn  | [supergateway]   - Headers: (none)
shadcn  | [supergateway]   - port: 8000
shadcn  | [supergateway]   - stdio: npx -y shadcn@latest mcp
shadcn  | [supergateway]   - streamableHttpPath: /shadcn
shadcn  | [supergateway]   - protocolVersion: 2024-11-05
shadcn  | [supergateway]   - CORS: disabled
shadcn  | [supergateway]   - Health endpoints: (none)
shadcn  | [supergateway] Listening on port 8000
shadcn  | [supergateway] StreamableHttp endpoint: http://localhost:8000/shadcn
shadcn  | [supergateway] Received GET MCP request
shadcn  | [supergateway] StreamableHttp → Child: {"jsonrpc":"2.0","id":0,"method":"initialize","params":{"_meta":{"progressToken":0},"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"lobehub-mcp-client","version":"1.0.0"}}}
shadcn  | [supergateway] Tracking initialize request ID: 0
shadcn  | [supergateway] Child → StreamableHttp: {"result":{"protocolVersion":"2025-11-25","capabilities":{"resources":{},"tools":{}},"serverInfo":{"name":"shadcn","version":"1.0.0"}},"jsonrpc":"2.0","id":0}

Additional Information

No response

[wanghe-fit2cloud]

感谢反馈，我们会在后续版本持续优化。