MCP Server Revision

角色

McpServerRevision 是不可变 MCP server 托管契约，定义 MCP capability profile、私有 tool catalog、运行画像、run policy 和鉴权要求。

核心字段

• mcpServerRevisionId
• mcpServerId
• orgId
• description
• mcpProfile
• toolCatalog
• executionProfile
• runPolicy
• authPolicy
• secretRefs
• createdAt

规范要求

• McpServerRevision 一旦创建 MUST 不可变
• McpServer 作为 direct run target 或 Agent 引用解析时 MUST 指向确定的 mcpServerRevisionId
• mcpProfile MUST 只声明 MCP capability、identity projection 和 canonical 语义映射，不声明 endpoint / transport / security 绑定
• toolCatalog[] 中的 name 在同一 revision 内 MUST 唯一
• 如 toolCatalog[] 条目引用 toolId，该 Tool MUST 属于同一 orgId
• 继续输入到托管 MCP session 的请求 MUST 保持 run 事件流和 interaction 语义的一致性

设计说明

• mcpProfile 负责 MCP 版本与能力面
• toolCatalog[] 负责 server 私有目录；需要平台级治理时可通过 toolId 引用已有 Tool
• executionProfile 与 runPolicy 负责托管 MCP session 的实际运行方式
• ProtocolBinding(protocol=mcp) 负责对外暴露 endpoint，而不改写 revision 语义