[P0][MCP] Remote MCP: Streamable HTTP transport + OAuth + Server Card

[linfangw]

背景

当前 MCP 服务器仅支持 stdio 传输(src/index.ts 只用 StdioServerTransport)。2026 年 MCP 生态已收敛到远程 MCP:Streamable HTTP 传输 + OAuth 2.1(audience binding)+ Claude Desktop Custom Connectors 一键连接;新规范还在推 .well-known 的 MCP Server Card 元数据用于注册表无连接发现。#29 完成了 Hosted MCP 的 onboarding 文档,但服务器本体还不支持 HTTP。

参考:MCP 2026-07-28 规范 RC(SEP-2243 要求 Streamable HTTP 带 Mcp-Method / Mcp-Name 头)。

工作内容

• @qverisai/mcp 增加 Streamable HTTP 传输模式(CLI flag 或 env 切换,stdio 保持默认兼容)
• OAuth 2.1 鉴权路径设计(与现有 QVERIS_API_KEY Bearer 方案并存)
• 提供 MCP Server Card(.well-known 元数据)
• 部署参考实现/文档(如 Cloudflare Workers 或等价 edge runtime)
• Claude Desktop Custom Connectors 一键连接路径验证

验收标准

• 同一份代码可 stdio 本地运行,也可 HTTP 远程部署
• 通过 Claude Desktop / 主流 MCP client 的远程连接实测
• Server Card 可被注册表爬取识别