Übersicht

Was es ist

Der Axon MCP Server ist ein Model Context Protocol Server, der KI-Assistenten einen Zugriff auf Expertenniveau auf eine Axon-Codebasis bietet. Er indexiert Axon-Quelldateien und HTML-Dokumentation, stellt Such- und Code-Generierungstools über MCP bereit und kann Abfragen gegen eine Live-SkySpark-Instanz ausführen.

Axon ist die domänenspezifische Sprache von SkySpark für Gebäudeautomation, HVAC-Steuerung und Energiemanagement. Der MCP Server verwandelt einen Ordner mit Axon-Code in eine strukturierte Wissensdatenbank, die jeder MCP-kompatible Client – Claude Desktop, Cursor, die MCP CLI – abfragen kann.

Was Sie damit tun können

• Suche über Axon-Code und Dokumentation — FlexSearch-gestützte Volltextsuche mit Relevanzwertung, Operator-Abfragen und regulären Ausdrücken.
• Neuen Axon-Code generieren — 33 kuratierte YAML-Vorlagen für häufige HVAC-, Energie-, Fehler- und Daten-Workflows. Generierter Code wird semantisch validiert, bevor er zurückgegeben wird.
• Code gegen eine Live-SkySpark-Instanz ausführen — führen Sie Haystack-Abfragen aus, werten Sie Axon-Ausdrücke aus und committen Sie Funktionen mit automatischer Versionierung.
• Aufrufgraphen analysieren — finden Sie Aufrufer und aufgerufene Funktionen, erkennen Sie zirkuläre Abhängigkeiten und identifizieren Sie die am häufigsten aufgerufenen oder komplexesten Funktionen.
• Semantische Suche mit Vektor-Embeddings — Abfragen in natürlicher Sprache, die Code nach Bedeutung zurückgeben, nicht nur nach Schlüsselwortübereinstimmung.

Wie alles zusammenpasst

┌──────────────────┐     MCP       ┌──────────────────────┐      HTTP    ┌────────────┐
│ AI Client        │ ─────────────▶│ Axon MCP Server      │ ────────────▶│ SkySpark   │
│ (Claude, Cursor) │               │  • Suchindex         │              │ (Haystack) │
│                  │               │  • Code Generator    │              └────────────┘
│                  │ ◀─────────────│  • Graph Analyser    │
└──────────────────┘    Ergebnisse │  • OAuth 2.1         │
                                    └──────────────────────┘
                                              │
                                              ▼
                                       .axon / .trio Dateien
                                       HTML Dokumentation

Verbindungen laufen über stdio (für lokale KI-Clients, die den Server als Unterprozess starten) oder http (für Remote-Clients hinter OAuth). Das Dashboard unter /admin bietet eine Web-UI für Sitzungs- und Benutzerverwaltung.

Wichtigste Funktionen

• Schnelle Suche — ~50 ms Volltextsuche über Tausende von HTML-Dateien; die anfängliche Indizierung dauert 30–60 s und wird zwischengespeichert.
• OAuth 2.1 mit PKCE — Multi-User-Authentifizierung, begrenzte Token (mcp:read, mcp:write, mcp:admin).
• Funktionsversionierung — speichert automatisch die letzten 4 Überarbeitungen jeder über den Server committeten Funktion.
• Auto-Discovery — konfigurieren Sie eine SkySpark-Instanz; der Server enumeriert Projekte und synchronisiert deren Funktionen automatisch.
• Lokale SQLite-Persistierung — Benutzerspeicher, Sicherungsmanifeste und Graphmetriken befinden sich alle in einer einzigen Datei über Prisma.

Projektstatus

Der Server ist in aktiver Entwicklung und gilt als stabil für Such-, Ausführungs- und Code-Generierungs-Workflows. Lizenz: ISC. Probleme und Beiträge sind auf GitHub willkommen.