mirror of https://github.com/NickoScope/nickol-knx-mcp.git synced 2026-09-29 19:31:12 +02:00

Files

T

Nikolay MiroshnichenkoandClaude Opus 4.8 bba8befcde nickol-knx-mcp v0.1.0 — design-time KNX/ETS6 MCP server (public beta)

Design-time MCP server that reads .knxproj (read-only), validates naming/DPT/status,
and generates Home Assistant KNX YAML + ETS-importable group addresses (XML/CSV).
No live bus access — confined-workspace writes only.

Includes: 12 MCP tools, end-to-end smoke test, MIT license, English-first README
(+ Russian), CONTRIBUTING with a real-project test call, SECURITY policy, CHANGELOG,
GitHub Actions CI (Python 3.10–3.12), and issue/PR templates.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-28 09:25:57 +02:00

1.5 KiB

Raw Blame History

Changelog

All notable changes to this project are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.1.0 — 2026-06-28

Initial public beta.

Added

Design-time MCP server with 12 tools: load_project, list_group_addresses, get_devices, get_topology, check_naming, check_missing_status, check_dpt, analyze_all, generate_ha_package, generate_ets_group_addresses, project_report, workspace_info.
Read-only .knxproj parsing via xknxproject (ETS5/ETS6, password-protected supported).
GA classification (category + kind) from DPT and multilingual (EN/DE/RU) name keywords.
Naming, missing-status, and DPT validation checks.
Home Assistant KNX YAML generation with a conservative review list for ambiguous items.
ETS-importable group-address export in XML (knx.org/xml/ga-export/01) and CSV.
Markdown project report.
Confined-workspace write guarantee (NICKOL_KNX_WORKSPACE); no bus access by design.
CLAUDE.md design playbook, end-to-end smoke test (synthetic 16-GA project), example Claude Desktop config.

Known limitations

Tested end-to-end on a synthetic project only; real-world .knxproj testing is ongoing (see the call for testers in the README).