knx-ets-mcp
KNX 智能家居总线 ETS 5/6 的 MCP 服务器：让 Claude/Cursor 等 Agent 通过 ETS Addin 读写楼宇自动化设备组地址与工程数据，把 KNX 调试接入 Agent 工作流。
这是什么？适合谁？
KNX ETS MCP（knx-ai/knx-ets-mcp）是一个KNX 楼宇总线的 MCP 服务器：KNX 智能家居总线 ETS 5/6 的 MCP 服务器：让 Claude/Cursor 等 Agent 通过 ETS Addin 读写楼宇自动化设备组地址与工程数据，把 KNX 调试接入 Agent 工作流。
核心价值：把专业 KNX 调试能力（ETS 组地址、工程数据）暴露给 AI Agent，让智能家居/楼宇自动化工程师可以用自然语言读写与排查设备。
适合人群：
- 做 KNX 智能家居/楼宇自动化集成的工程师
- 用 Agent 处理 ETS 工程数据的调试人员
- 研究 MCP 与建筑总线结合方向的开发者
使用前提：KNX ETS 5/6 环境、ETS Addin，以及支持 MCP 的客户端（Claude Desktop/Cursor 等）
准备工作
- 安装：从 GitHub 克隆 knx-ai/knx-ets-mcp 并按 README 构建
- 环境：Windows + ETS 5/6 + ETS Addin
- 客户端：Claude Desktop / Cursor 等 MCP 客户端
- 成本：开源免费（仓库未声明标准许可证，商用前需确认授权）
- 时间：安装 + 首次连接约 30 分钟
快速上手（3 步）
第一步：构建并安装 MCP 服务器
git clone https://github.com/knx-ai/knx-ets-mcp && cd knx-ets-mcp
克隆仓库并按 README 完成构建，把 MCP 服务器跑起来。
第二步：在 MCP 客户端注册
# 在 Claude Desktop/Cursor 的 MCP 配置中加入 knx-ets-mcp 命令
把服务器命令写入客户端 MCP 配置，让 Agent 能调用它。
第三步：读写组地址与工程数据
# 对 Agent 说：列出当前 ETS 工程里的组地址并汇总状态
用自然语言让 Agent 通过 ETS Addin 读写设备组地址与工程数据。
成功判定：Agent 成功连上 ETS 工程，能列出并读写 KNX 组地址，完成一次楼宇设备的调试查询。
初级用法
读取组地址
通过 Agent 读取 ETS 工程中的 KNX 组地址列表与绑定关系。
写入设备参数
经 ETS Addin 修改设备参数并下发到 KNX 总线。
工程数据排查
让 Agent 汇总工程数据、定位配置不一致的组地址。
高级玩法
楼宇自动化巡检
把组地址状态读取做成定时巡检，接入 Agent 自动汇总异常。
与视觉监控联动
结合监控事件触发 KNX 场景（如灯光/窗帘联动）。
多工程批量核对
跨多个 ETS 工程批量比对组地址定义，找出命名漂移。
小技巧
-
- 先备份 ETS 工程再让 Agent 写入
-
- 写入操作加人工确认，避免误改总线设备
-
- 用只读模式先熟悉命令面
-
- 确认 ETS Addin 与 ETS 版本匹配
-
- 组地址命名规范化后再交给 Agent 管理
常见踩坑
踩坑 1：ETS Addin 版本不匹配
- 现象：MCP 服务器连接 ETS 失败
- 原因：ETS 5/6 与 Addin 版本不对应
- 解决：按 README 对齐 ETS 与 Addin 版本
踩坑 2：总线写入影响现场设备
- 现象：误改组地址导致设备动作异常
- 原因：直接写入生产总线
- 解决：先在测试工程验证，写入加确认
踩坑 3：客户端未识别 MCP 服务器
- 现象：Agent 看不到 knx-ets-mcp 工具
- 原因：MCP 配置路径或命令不对
- 解决：核对客户端 MCP 配置与可执行路径
踩坑 4：工程数据读取不全
- 现象：部分组地址读不到
- 原因：ETS 工程未完全加载或权限不足
- 解决：确认 ETS 工程打开且登录账号有权限
踩坑 5：许可证不明确
- 现象：商用部署存在合规风险
- 原因：仓库未声明标准开源许可证
- 解决：商用前联系作者确认授权
常见问题 FAQ
Q1: 它支持 ETS 哪个版本？
A: 面向 ETS 5/6，通过 ETS Addin 交互，以仓库 README 为准。
Q2: 需要 KNX 硬件吗？
A: 需要已配置的 ETS 工程与 KNX 总线/设备，MCP 本身是软件层。
Q3: 免费吗？
A: 代码开源，但未声明标准许可证，商用前需确认授权。
Q4: 能直接控制设备吗？
A: 可经 ETS 工程读写组地址，是否下发到现场取决于工程配置。
Q5: 哪些客户端能用？
A: 支持 MCP 的客户端如 Claude Desktop、Cursor 等。
进阶学习建议
掌握基础后，建议深入：
-
- 研究 ETS Addin 的自动化接口边界
-
- 把 KNX 组地址建模成 Agent 可理解的资源图
-
- 结合 KNX 场景与其它智能家居协议做统一编排
参考链接
最后更新：2026-09-01 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成
📊 评分与标签
评分说明
总分 7.4/10 · S_入选
📊 可观测社区指标（采集日期：2026-09-01）
- GitHub: knx-ai/knx-ets-mcp ★23, 🔱2（GitHub API 实时验证）
- License: 未声明许可证（GitHub 未检测到标准许可证）；仓库创建 2026-08-29，最后推送 2026-08-31
- 语言: C#；定位「KNX 楼宇总线调试 MCP 服务器」
⚙️ 功能完整度 1.8/2.5
- 覆盖组地址读写与工程数据操作，面向 ETS 5/6 的完整 MCP 能力
- 来源：官方仓库
- 竞品对比 1（手动 ETS 操作）：无 Agent 接入，效率低
- 竞品对比 2（通用 MCP 模板）：无 KNX 领域深度
✨ 输出质量 1.8/2.5
- 把专业 KNX 调试能力以结构化工具暴露，输出可被 Agent 直接消费
- 来源：官方仓库
- 竞品对比 1（ETS 原生 GUI）：不产出结构化结果
- 竞品对比 2（脚本化 ETS）：需自行维护接口
🖐️ 易用性 1.2/1.5
- 需要 ETS + Addin 专业环境，上手有一定门槛
- 来源：官方仓库
- 竞品对比 1（图形化调试器）：门槛低但能力弱
- 竞品对比 2（自研总线工具）：门槛更高
💰 性价比 1.3/1.5
- 代码开源免费，无订阅成本
- 来源：官方仓库
- 竞品对比 1（商业 KNX 管理软件）：授权贵
- 竞品对比 2（人工外包调试）：按次收费
🔒 稳定性 0.6/1.0
- 项目新（08-29），23 星 2 fork，稳定性待观察
- 来源：官方仓库
- 竞品对比 1（成熟 KNX 工具）：久经考验
- 竞品对比 2（实验项目）：更不稳定
🛡️ 隐私安全 0.7/1.0
- 本地运行不传数据到云，但许可证不明确带来合规不确定性
- 来源：官方仓库
- 竞品对比 1（云托管方案）：工程数据上传第三方
- 竞品对比 2（商业闭源工具）：不可审计
评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。
🏷️ 标签说明
- AI开发平台: 面向楼宇自动化的 Agent 开发工具 来源：官方仓库
- 开源: 代码公开但未声明标准许可证 来源：官方仓库
- 智能家居: 服务 KNX 智能家居/楼宇总线 来源：官方仓库
- KNX: 面向 KNX 标准总线 来源：官方仓库
- MCP: 以 Model Context Protocol 形态接入 Agent 来源：官方仓库
📋 来源核实
- ✅ 已验证: GitHub 仓库 - stars/forks/license/pushed_at/语言经 GitHub API 实时核验（2026-09-01）
- ✅ 已验证: 官方 README - 能力与定位比对
- ⚠️ 未实测: KNX ETS MCP 的端到端运行流程
- ⚠️ 未验证: 生产环境的稳定表现
⚠️ 局限与未实测声明
- 本文基于 2026-09-01 GitHub 公开信息整理，未实际运行 KNX ETS MCP
- 项目较新（2026-08-29 创建），能力与命令以仓库 README 为准
同分类推荐
AI开发平台 分类下的其他工具