nickol-knx-mcp v0.1.2 — a design-time KNX/ETS assistant (MCP server). Beta, testers wanted.

[NickoScope]

Hi everyone 👋

I'm releasing nickol-knx-mcp — an open-source, design-time assistant for KNX/ETS, exposed as an MCP server. From Claude (or any MCP client) it reads your .knxproj read-only, validates it, and generates your Home Assistant + ETS files — and it never touches the bus (there are no bus/networking libraries in it at all; bus_access: false, by design).

What it does

• Validates naming, DPT discipline, and command↔status pairing (using the roles in your ETS Functions, not guesswork).
• Generates a Home Assistant KNX package and ETS-importable group-address exports (XML/CSV).
• Writes a human-readable report you review before importing anything.

Proof it's real

I hammered it on public ETS 4.2 / 5.0 / 5.5 / 6 projects — it immediately found a critical bug in itself plus several real-world classification gaps (German shutter naming, 1.001+1.017 blinds, dimmer status pairing, datetime DPTs). All fixed, each with a regression test. There's a full 239-GA / 47-Function demo house with a Home Assistant "brain" (circadian lighting, an 8-factor climate setpoint, presence/season/time logic, statistics) and a 5-view dashboard.

🔗 Live demo + screenshots: https://nickoscope.github.io/nickol-knx-mcp/

It's a beta — and that's the invitation

It's passed synthetic + public-fixture tests, but real ETS projects are gloriously messy and I've seen only a few. Please try it on your own .knxproj (read-only, safe) and open a Real-project test report — what it got right, what it got wrong. Code contributions and weird regional DPT/naming examples are just as welcome.

MIT · Python 3.10+. Thanks for taking a look 🙏

---

🇷🇺 По-русски

Выкладываю nickol-knx-mcp — открытый design-time ассистент для KNX/ETS в виде MCP-сервера. Он только читает ваш .knxproj, проверяет его и генерирует конфигурацию Home Assistant + файлы для ETS — и никогда не лезет в шину (в нём вообще нет сетевых/шинных библиотек; bus_access: false).

• Проверяет именование, дисциплину DPT и парность команда↔статус (по ролям из ваших ETS Functions).
• Генерирует HA KNX-пакет и ETS-импортируемые экспорты групповых адресов (XML/CSV).
• Делает человекочитаемый отчёт, который вы смотрите до импорта.

Прогнал на реальных публичных проектах ETS 4/5/6 — нашёл критический баг в себе + несколько реальных пробелов классификации, всё исправлено с регресс-тестами. Есть полный демо-дом из 239 GA / 47 Functions с HA-«мозгом» и дашбордом на 5 экранов. 🔗 https://nickoscope.github.io/nickol-knx-mcp/

Это бета — прогоните на своём .knxproj (только чтение, безопасно) и заведите Real-project test report. Контрибуции и «странные» региональные примеры DPT/нейминга — очень нужны. MIT · Python 3.10+. Спасибо! 🙏

[NickoScope]

Update — the tool has grown a lot since v0.1.2 (now v0.6.0).

nickol-knx-mcp went from a validator to a full design-time assistant — 24 MCP tools:

• Validate: naming · DPT & sub-DPT · command↔status · KNX Secure posture + keyring checklist · Matter-readiness · energy
• Repair (not just flag): suggest_repairs proposes concrete fixes — infers DPTs, synthesises missing status GAs, adds absolute-brightness GAs
• Device library: decompose_device expands a device (order number) into its group-address recipe (Zennio + ABB)
• As-built handover pack, semantic project diff between two .knxproj versions, completeness grade (skeleton vs as-built), an acceptance test-protocol draft, and a KNX IoT (Turtle/RDF) export
• HA YAML now also assembles a time/date expose and surfaces cover invert/travel flags

Still read-only, no bus. Latest release: v0.6.0. Testers on real .knxproj files very welcome — reply here or open a Real-project test report.

🇷🇺 Инструмент вырос из валидатора в полноценного design-time ассистента (24 тула): валидация (incl. sub-DPT, KNX Secure, Matter) + починка (suggest_repairs) + device-library (decompose_device) + пакет сдачи + diff версий + Matter/IoT-экспорт. Последний релиз — v0.6.0. Тестировщики на реальных .knxproj очень нужны.

[NickoScope]

📦 v0.7.0 is out — exact device models (25 MCP tools)

Two additions in this release:

• parse_devices_from_project (new tool) — extracts the exact vendor comm-object model (order number, app-program version, object counts, per-channel blocks with stride, true DPTs) from the M-* application programs inside a .knxproj / .knxprod. Read-only and PII-safe: it never touches the client project data. It can write the result as device-library YAML.
• Catalog-exact decompose_device — point NICKOL_KNX_CATALOG at that YAML and decompose_device returns the exact vendor object model (source: catalog-exact) instead of a generic recipe; without the env everything works as before. DPTs the vendor never declared stay null — never guessed.

Together they close the loop: parse your project's app-programs → local catalog → exact decomposition.

Release notes: https://github.com/NickoScope/nickol-knx-mcp/releases/tag/v0.7.0

[NickoScope]

v0.8.0 is out — lessons from a second real-world integrator naming school (anonymised): (1) positional command/status pairing — parallel status middles with 1:1 duplicated names + self-reporting R+T objects; missing-status warnings on the field project dropped 339→89 (the real ones); (2) app-program parser v2 — merges ComObjectRef-level names/DPTs/flags (HDL/Ekinex-style publishers), unverified DPTs −73% on the same archive, and the newest ApplicationVersion is now picked correctly; (3) two detector fixes (authoritative main-range names; the completeness grader now counts pattern-named ranges). Release: https://github.com/NickoScope/nickol-knx-mcp/releases/tag/v0.8.0

[NickoScope]

New in main (unreleased): skills/ha-git-backup — an ops-companion skill.

Scenario 3 ends with generate_ha_package handing you Home Assistant YAML; this covers the life of your /config after deploy, as a two-circuit system:

1. History — a real git repo inside /config, pushed over a single-repo deploy key, with a pre-commit secret scanner that blocks any commit whose diff contains a token/password/private key. "What broke my automation last night" = one git diff.
2. Recovery — full native HA backups (including .storage) age-encrypted and rotated in GitHub Releases; the private key never touches the HA host. Plus a mandatory monthly restore drill.

Ships ready-made scripts (install / sync / secret-scan / offsite / restore), HA automations and a restore runbook, in EN + RU: skills/ha-git-backup. It doubles as a Claude skill — drop SKILL.md into .claude/skills/ and Claude walks you through setup and incidents.

Feedback welcome — especially from anyone running HAOS with the SSH add-on.