L1 AI 接入协议(MCP 绑定)v0.1

DRAFT本版本为 Draft 草案,允许迭代、不承诺兼容。正式兼容承诺自 v1.0 起生效,详见版本政策

L1 AI 接入协议定义「AI 平台如何接入 Open AIoT」:以 MCP(Model Context Protocol)为绑定,把 L0 能力映射为 AI 可直接调用的工具——一次接入,所有达标的 AI 平台通用。

本页是导言。规范正文同步自 spec 仓库,以仓库版本为准:github.com/Open-AIoT/spec;参考实现见 mcp 仓库

为什么是 MCP

MCP 已经成为 AI 客户端接入外部工具的事实标准:Kimi、Claude Desktop、Cursor 等主流平台都支持。Open AIoT 不另造协议——L1 就是「Open AIoT 能力模型在 MCP 上的绑定」,AI 平台零改造即可接入。

绑定做了什么

  • 连接建立:MCP Server 作为设备侧与 AI 客户端之间的桥,负责鉴权与会话。
  • 能力映射:L0 的属性/动作/事件映射为 MCP 的工具(tools)与资源(resources),AI 按标准方式发现并调用。
  • 调用与回执:工具调用携带 L2 授权凭据,执行结果与确认请求按规范格式返回。

本版本(v0.1)要点

  • MCP Server 绑定的最小约定:工具命名规约与能力描述的序列化格式。
  • 设备列举、状态读取、动作执行三类基础工具的调用流程。
  • 错误与确认请求的统一返回结构(与 L2 人在环路配合)。

动手接入看《5 分钟接入指南》;MCP Server 下载与部署资源在开发者页

对此规范提建议 → 到 GitHub 发起 RFC;流程见RFC 索引