MCP v2 实验场

这是个能直接跑起来的 MCP v2 实验仓库。协议、MCP App、Skills 和 Codex 会话被放进同一条验证链路。哪些已经可用，哪些还卡在客户端，都直接写在下面。

实验内容

这里的 legacy SSE 仅指 2025-06-18 stateless POST 响应的 text/event-stream 封装；项目没有旧式独立 SSE endpoint，也没有实现 subscriptions/listen。responseMode: "json" 只约束 2026-07-28 modern 请求，不能据此宣称所有兼容请求都是 JSON 响应。

当前项目定义的八类运行时能力均已实现。Skills 是 Tool 组合出的应用层能力； Tasks 也采用 tasks.* Tool 模型，因为当前 2026-07-28 SDK 已不提供旧版 原生 Tasks 运行时。Auth 在设置 MCP_AUTH_TOKEN 后启用；未设置时保留本地 免鉴权开发模式。

Related MCP server: MCP Hello World

场景化验证中心

验证中心不再用六套特征卡和证据卡重复解释 v2，也不把六个运行面误画成固定 协议顺序。一个 React Flow 动态路由按 server/discover、运行面、协议模式、 能力选择和有界参数生成当前路线：发现能力 → 条件选路 → 命中节点 → Verdict → 重新发现。左侧入口用于选择运行面，上方条件控件直接来自服务端动态入口； 每次只运行当前命中的真实路线。

服务端仍保留六个相互隔离的动态入口和 latest report 槽位；条件变化后，旧 报告必须与新的 protocol、selection 和 parameters 完全匹配才可继续投影。 老版本切换只改变 Flow 结构并标记为概念对照，运行按钮禁用且不会自动切回 v2；真实 Legacy 路线通过协议入口选择。服务端的 25 个自动化用例继续作为 独立门禁执行。

orders.dashboard 是这里最直观的实验。它返回一个 React + shadcn/ui Dashboard，组件里的 Tabs 和 Select 会再次调用 Tool，拿到新的 structuredContent 后切换视图。

{
  "view": "orders",
  "status": "paid"
}

这组参数会返回一条演示订单 ord_demo_1001。Codex CLI 能拿到结果； 当前 Codex Desktop 还没有把 MCP App 真正渲染到会话里。主 Flow 验证 Tool、ui:// Resource、bridge 与 render 的服务端路线证据；MCP App 自身仍 单独构建和测试，但当前精简后的验证中心不再嵌入 iframe Widget。

运行

bun install
bun run dev

• 验证中心：http://localhost:3000/

• MCP Server：http://localhost:3001/mcp

生产容器把构建后的验证中心、/api 和 /mcp 统一暴露在 3000 端口：

docker compose -f compose.production.yml build
docker compose -f compose.production.yml up -d

生产入口：https://mcp-v2.kenvoai.com/，MCP Endpoint： https://mcp-v2.kenvoai.com/mcp。容器以非 root、只读文件系统运行，并通过 共享 edge 网络交给 Caddy 终止 TLS。

完整验收：

bun run acceptance

它会执行 TypeScript 7 类型检查、Bun 测试、Rsbuild 构建、HTTP 验收、Playwright 桌面与移动端验收，以及面向 Codex 的客户端调用链。

目录

apps/mcp-app   shadcn/ui MCP App，构建为单文件 HTML
apps/web       单主场景 React Flow 验证中心
services/mcp   Bun MCP Server、Tool、Resource 和验收脚本
packages/shared
               共享契约与测试夹具

详细结果见 验证报告。本轮用例范围和完成边界 记录在 E2E 验收规划。