common_agent/docs/设计文档/6.MCP能力接入模块设计.md

MCP 能力接入模块设计

1. 核心模型

对象	说明
MCP Server	外部能力服务
MCP Capability	Server 暴露的工具或资源
Manifest	Server 能力声明

2. 导入流程

flowchart LR
    Input["输入 URL/package/Manifest"] --> Validate["校验连接与声明"]
    Validate --> Server["写入 mcp_server"]
    Server --> Capability["写入 mcp_capability"]
    Capability --> Binding["绑定给 Workflow/Agent"]

3. 设计约束

• secret_ref 只保存密钥引用，不保存明文密钥。
• manifest_json 保存原始能力声明摘要。
• schema_json 保存单个能力输入输出 schema。
• Server 停用时，其能力不应被新运行选择。