一个 MCP 服务器，四种楼宇自动化协议，零胶水代码。
Sedona MCP 服务器通过二进制 TCP 在 1876 端口上使用 Sedona Sox，通过 HTTP 在 8085 端口上使用 Sedona Weblet，通过 Sandstar 的 Project Haystack 桥接，以及通过 HTTPS 使用 SkySpark -- 全部在统一的 MCP 工具表面后面。要求它搜索 Sedona 类、生成组件代码或对运行中的 SkySpark 项目执行实时 Axon，协议路由层就会确定使用哪个传输。
离线时，它用 FlexSearch 索引 27 多个 Sedona 示例、工具包、类、模式和模板。在线时，它可以访问真实的楼宇。
存在的原因
现代控制栈不是一个协议 -- 它是四个，有时五个。工程师需要为每个协议使用不同的工具，每次切换时都会失去上下文。Sedona MCP 服务器将这一切合并为一个对话：助手请求 executeAxonCode，服务器处理到 SkySpark 的 HTTPS 和 SCRAM 握手；它请求 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）