一个 MCP 服务器,四种楼宇自动化协议,零胶水代码。
Sedona MCP 服务器通过 1876 端口的二进制 TCP 支持 Sedona Sox,通过 8085 端口的 HTTP 支持 Sedona Weblet,支持 Sandstar 的 Project Haystack 桥接,以及通过 HTTPS 支持 SkySpark——所有这些都在统一的 MCP 工具表面后面。要求它搜索 Sedona 类,生成组件代码,或对运行中的 SkySpark 项目执行实时 Axon,协议路由层就会确定要拨通哪个传输。
离线时,它使用 FlexSearch 索引 27+ 个 Sedona 示例、套件、类、模式和模板工具。在线时,它可以访问真实建筑。
存在的原因
现代控制堆栈不是一个协议——它是四个,有时五个。工程师为每个协议使用不同的工具,每次切换时都会失去上下文。Sedona MCP 服务器将其压缩成一个对话:助手调用 executeAxonCode,服务器处理 HTTPS 和 SCRAM 握手到 SkySpark;它调用 searchSedonaClasses,服务器访问本地索引;它调用 getActiveConnection,服务器报告当前绑定的是哪个设备。
适用对象
- 控制工程师在同一项目中跨 Sedona 设备和 SkySpark 项目工作
- Sandstar 开发人员将 Haystack 标签桥接到 Sedona 硬件
- AI 辅助集成商希望使用一个 MCP 服务器,而不是四个
协议交换机
四种协议,一个 MCP 工具调用
一个配置文件定义你的 Sox 设备、Weblet 服务器、Sandstar 桥接和 SkySpark 实例。任何工具调用都会路由到正确的传输——二进制 TCP、HTTP、HTTPS——无需单行胶水代码。
工具表面
六个领域,一个接口
搜索、生成、验证、分析、执行、连接。二十七个以上工具,按你要执行的操作组织——而不是你要访问的协议。
助手无需知道线路格式。它为任务选择工具。路由器拨号到正确的目的地。
实时连接
四条路线,一个仪表板
每个连接都单独跟踪。getActiveConnection 报告最后使用的协议。discoverInstanceProjects 遍历任何可达的内容。clearProjectCache 在某些事物偏移时重置。
配置文件是唯一的信息来源。添加新的 SkySpark 实例,添加新的 Sedona 设备,更改端口——路由器在下一个工具调用时重新读取。
SkySpark 执行
从目录到建筑
executeAxonCode 对当前绑定的 SkySpark 项目运行任意 Axon。listSkySparkProjects 和 switchSkySparkProject 让你在实例中漫游。discoverProjectFunctions 进行自省;getProjectSchema 返回数据模型。
项目状态持续存在。切换一次,接下来的 50 个工具调用都会转到同一个建筑。切换回去,缓存就已经准备好了。
| dis | zone | val | ts |
|---|---|---|---|
| Zone 101 | core-1 | 72.3°F | 10:12 |
| Zone 102 | core-1 | 74.1°F | 10:12 |
| Zone 103 | core-1 | 71.8°F | 10:12 |
| Zone 201 | core-2 | 73.4°F | 10:12 |
| Zone 202 | core-2 | 72.9°F | 10:12 |
Sedona 设备
二进制轨道上的一流自省
listSedonaKits 遍历设备清单。getActiveConnection 报告绑定的主机。discoverInstanceProjects 自动将发现的设备与其项目上下文配对。Sox 被视为 HTTP 的同级,而不是遗留传输。
二进制并不意味着不透明。每个类、每个套件、每个固件版本都对助手可见——并且可搜索。
技术栈
架构
功能特性
- 27+ MCP 工具 -- 按关注点组织:Sedona 搜索、代码生成、函数分析、SkySpark / Axon 执行、设备 / 连接管理、Haystack 查询
- 多协议路由 -- Sedona Sox(二进制 TCP 1876)、Sedona Weblet(HTTP 8085)、Sandstar Haystack 桥接、SkySpark HTTPS 443(带 SCRAM 认证)
- FlexSearch 索引 -- Sedona 示例、操作员示例、文档、类、套件、模板和模式,用于离线查询
- 代码生成和验证 --
generateSedonaCode和validateSedonaCode,具有套件感知模板 - 双向调用图和使用情况分析 -- 在整个 Sedona 代码库中
- 实时 SkySpark 和 Axon 执行 -- 支持项目切换和按实例项目缓存
- YAML 和 JSON 配置 --
config/connections.json用于按协议的声明式连接定义
里程碑 v2.0.0
从仅 Axon(v1.x)扩展到多协议统一服务器:Sedona Sox 加 Weblet 加 Sandstar 加 SkySpark。
要求
- Node.js 18+
config/connections.json为你使用的每个协议填充- 网络可达性到 Sox 设备(TCP 1876)、Weblet / Sandstar(HTTP 8085)和 / 或 SkySpark(HTTPS 443)