MCP 与工具服务 ​

状态：待开发。 当前只有 services/ontology-mcp/ 目录骨架。

负责 MCP Server、Tool Registry 与 Harness 接入。工具的可见性受策略和租户约束；实际读取或执行复用运行时和 Action 服务，不另建业务规则副本。

负责范围 ​

• 将已发布 Function 和 Action 投影为版本化工具定义。
• 按租户、主体、Agent、委托范围和策略过滤工具发现结果。
• 验证工具输入输出，传递身份、模型版本、traceId 和幂等键。
• 把只读调用路由到 Runtime，把有副作用调用路由到 Actions。
• 管理 Tool Registry 的版本、弃用、能力声明和 Harness 兼容信息。

不复制 Runtime 的查询逻辑，不复制 Actions 的状态机，也不允许 Harness 自报身份绕过平台认证。

工具契约 ​

工具定义包含稳定名称、版本、说明、输入输出 Schema、副作用级别、审批可能性、超时、数据敏感级别和幂等要求。MCP 定义以 contracts/mcp/ 为准，并引用 contracts/schemas/ 中的公共类型。

委托与安全 ​

Agent 调用必须关联最终用户或服务委托，记录委托者、受托 Agent、客户端和有效范围。工具目录不能泄露当前主体无权知道的实体、字段或 Action。高风险工具需要显式确认、审批或更强身份验证时，由策略结果驱动。

验收重点 ​

• REST 与 MCP 对同一业务能力复用相同模型、策略和执行语义。
• 工具发现与执行使用同一授权上下文，避免可见但不可执行或越权执行。
• 输入、输出和错误符合版本化 Schema。
• Harness 断连不会丢失异步 Action 的 executionId 和查询入口。