主题
MCP Server Profile
目标
MCP 在 AaaS v1 中是以 McpServer 为中心的 server-first 互操作面,用于承载 tool catalog、prompts/resources 能力,以及托管 MCP session 的标准暴露方式。
这意味着 AaaS 可以原生对齐 A2A、ACP、AG-UI 等 northbound surface,同时把 MCP 收敛到 McpServer / McpServerRevision / ProtocolBinding(protocol=mcp) 的 canonical 资源模型。
档案声明
- MCP capability 由
McpServerRevision.mcpProfile声明 - 实际 endpoint、transport 和 security 由
ProtocolBinding(protocol=mcp, targetType=mcp_server_revision)声明 protocolVersion表示 MCP 版本,不等于 AaaS/v1- Agent 如需暴露某个 MCP server,
MUST通过AgentRevision.callableRefs[]中resourceType=mcp_server且bindingMode=inject的条目引用稳定的McpServer
核心映射
| MCP 概念 | AaaS canonical model |
|---|---|
| server identity | McpServer |
| server contract | McpServerRevision |
| MCP endpoint | ProtocolBinding(protocol=mcp) |
| session bootstrap | CreateRun(resourceType=mcp_server) |
| subsequent request | ContinueRunCommand(mode=mcp_server) |
| tool list | McpServerRevision.toolCatalog[],以及可选的 Tool 引用 |
| tool result | tool result 事件、消息投影或 Artifact |
映射原则
McpServer是稳定 server 身份,McpServerRevision是不可变托管契约- MCP session
MUST复用 Agent Service 的 run、attempt、interaction 和 event 模型 - standalone
Tool仍然是平台级能力对象;McpServerRevision.toolCatalog[]可以嵌入私有目录,也可以通过toolId引用已有Tool - Agent 对 MCP 的暴露是对
McpServer的 callable 引用,而不是在AgentRevision.protocolProfiles内重建一套 MCP 真源 - 如果 MCP 经由 ACP 或其他协议协同暴露,底层 server 真源仍然是
McpServer/McpServerRevision
规范要求
ProtocolBinding(protocol=mcp)MUST绑定到mcp_server_revisionresourceType=mcp_server的 direct runMUST表示托管 MCP session,而不是一次性 tool 调用- 托管 MCP session 的后续 request
MUST通过ContinueRunCommand(mode=mcp_server)进入 canonical write path toolCatalog[]条目在同一McpServerRevision内nameMUST唯一- MCP 适配层
MUST把鉴权、配额、限流和审计绑定到 AaaS 的组织与 run 作用域 - MCP 调用结果如进入 run 输出流,
MUST转换为标准 tool call / result 事件 - MCP transport 和会话模型
MAY有自己的版本演进,但MUST NOT改写 canonicalMcpServer、Tool或Run资源字段语义
设计说明
- AaaS v1 不要求每个 Agent runtime 自己实现 MCP;平台可以统一提供 MCP adapter 或托管 MCP runtime
- MCP 的 server 真源在
McpServerRevision上,而不是AgentRevision.protocolProfiles.mcp - Agent 如需附带 MCP 能力,推荐在
callableRefs[]中引用一个或多个McpServer,而不是复制 server 定义