SenseCAP PaaS MCP 数据桥 — 部署指南

在 GitHub 上查看源码
AI 辅助通道

还没定硬件?还是设备已到手准备安装?

不想在网页上手动勾选或敲命令?你可以让 AI 助手根据现场情况自动核算主机与配件,或者在设备通电后一键运行脚本自动安装。

方案自助咨询与部署
套餐

SenseCAP PaaS MCP 数据桥

部署一个常驻的轻量桥接服务,通过 MCP(Model Context Protocol)把你的 SenseCAP PaaS 账号数据接入小智语音助手(或任意兼容 MCP 的宿主)。

设备用途
任意 Docker 主机(如 reComputer R1100)运行 MCP 数据桥容器

你将获得:

  • 暴露给语音助手的 9 个 MCP 工具:设备总览播报、单设备详细读数播报、注册设备、查询设备 key、读取最新遥测数据、查询历史遥测数据、聚合绘图数据点、浏览/读取 Arduino 代码模板
  • 一条出站连接到你的小智 MCP 接入点的 WebSocket 连接——不开放任何入站端口,不对外暴露
  • 凭据只在部署时传入,不会打进镜像——之后随时可以用新凭据重新部署

前置条件: 已安装 Docker · 一组 SenseCAP PaaS Access ID/Key(sensecap.seeed.cc → API 密钥)· 从小智智控台获取的 MCP 接入点地址

1

部署 MCP 数据桥

用你的 SenseCAP PaaS 凭据和小智 MCP 接入点部署桥接容器。

部署完成后

数据桥已启动,并已连接到你的小智 MCP 接入点。

验证一下

  1. 打开小智 App 或设备,开始一段对话
  2. 说一句类似「我的设备现在怎么样」的话
  3. 小智应该会调用数据桥的 get_farm_overview 工具,念出你有几台设备、有没有需要关注的
  4. 再问一句某个具体设备,比如「大棚气象站现在怎么样」——小智应该会调用 get_device_reading,把这台设备当前每个通道的读数念给你听

下一步

  • 项目 README —— 完整工具列表以及手动/stdio 用法
  • 要更换凭据,直接用新的 Access ID/Key 或接入点地址重新部署这一步即可,无需重新构建镜像
部署方式

部署在你正在使用的这台机器上。

部署时需要填写(在 SenseCraft Solution 应用里填)
  • SenseCAP PaaS Access ID*

    SenseCAP PaaS 开放平台的 API 凭据(sensecap.seeed.cc → API 密钥)

  • SenseCAP PaaS Access Key*

    与上面 Access ID 配对的 API 密钥。仅作为部署时的环境变量注入,不会打进镜像。

  • 设备所在时区(可选)

    播报设备上报时间时使用的 IANA 时区(如 Asia/Shanghai)。留空时国内站默认用北京时间,其余站点默认用 UTC——不会猜一个不确定的时区。

  • 小智 MCP 接入点地址*

    从小智智控台获取的 MCP 接入点地址(带鉴权 token,按密钥处理)

其余 1 项已有默认值,可不改
  • SenseCAP 站点默认 global
    3 项可选
    • · 国际站
    • · 国内站
    • · develop(内部测试)

    要对接的 SenseCAP PaaS 环境

故障排查
问题解决方法
找不到 Docker安装 Docker Desktop 并确保其正在运行
容器反复重启查看日志:docker logs sensecraft-data-mcp —— 通常是 Access ID/Key 或接入点地址填错了
小智一直不调用工具确认 MCP 接入点地址(包括 ?token= 部分)是从小智智控台完整复制过来的
播报的时间差好几个小时把"设备所在时区"填成设备实际所在的 IANA 时区(如 Asia/Shanghai)再重新部署。留空时国内站默认按北京时间处理,其余站点默认按 UTC 处理——不会瞎猜时区