Axon MCP Server
Eine KI-abfragbare Bibliothek von Axon-Wissen
Geben Sie KI-Assistenten Zugriff auf Expertenniveau für Ihre Axon-Codebasis.
Axon MCP Server indiziert tausende Axon-Funktionen, Operator-Nutzungen und SkySpark-Dokumentationsseiten in einer durchsuchbaren Bibliothek und stellt sie dann über das Model Context Protocol bereit. Jeder MCP-kompatible Assistent – Claude Desktop, Cursor, benutzerdefinierte Tools – kann Ihr Axon-Wissen wie ein leitender Ingenieur abfragen: nach Operator suchen, Nutzungsbeispiele abrufen, Aufrusgraphen verfolgen, typisierten Code generieren und vor der Ausführung validieren.
Indizieren Sie 4.000+ HTML-Dokumente in 30 bis 60 Sekunden. Fragen Sie sie in unter 50 Millisekunden ab. Behalten Sie den Cache 24 Stunden lang, damit nachfolgende Starts sofort erfolgen.
Warum es existiert
Axon ist eine domänenspezifische Sprache – eine kleine, seltsame, wunderschöne – und die meisten LLMs haben sie noch nie gesehen. Ohne Kontext weigert sich ein Assistent entweder zu helfen oder halluziniert selbstbewusst eine Funktion, die nicht existiert. Axon MCP Server schließt diese Lücke mit einer fundierten Wissensebene: Jeder Vorschlag kommt aus echtem indiziertem Code, jede generierte Funktion wird vorvalidiert und jeder Aufrusgraph ist bidirektional.
Für wen es gedacht ist
- SkySpark-Entwickler, die HLK-, Energie- und Spark-Logik schreiben und einen echten KI-Pair-Programmer möchten
- Gebäudeautomations-Integratoren, die Wissen über Dutzende von Axon-Projekten konsolidieren
- Berater, die in die Axon-Codebasis eines neuen Kunden einsteigen und schnelle Navigation benötigen
Durchsuche die Bibliothek
Jedes Axon-Beispiel, eine Abfrage
4.187 Dokumente. Suche unter 50ms. Indizierte Kategorien, Operatoren und Muster, alle abfragbar über eine MCP-Schnittstelle.
Gibt den Belegungsplan für eine Zone basierend auf Wochentag und Sollwertmodus zurück. Wird häufig als Gate in Runtime- und Rollup-Pipelines verwendet.
Berechnet die stündliche Laufzeit für ein Gerät über einen Datumsbereich. Respektiert Belegungsgating und manuelle Überschreibungspunkte.
Rollup der Zonentemperatur-Historie in tägliche Durchschnitte, typisiert zu °F oder °C basierend auf Site-Tag-Konventionen.
Berechnet einen wetterbereinigte Energiegrundlinie für einen Standort aus historischen Zählerdaten und Heizgradtag-Eingaben.
Schreibt einen neuen Sollwert auf einen Punkt-Datensatz mit Prioritätsabwicklung und Audit-Trail-Verlaufsmarkern.
MCP-Tool-Oberfläche
Eine kompakte Schnittstelle, 20 spezialisierte Tools
Jedes Tool, das der Assistent benötigt, ist ein JSON-Aufruf entfernt. Der Server macht vier Gruppen verfügbar: Suche, Funktionsanalyse, Code-Generierung und Live-SkySpark-Zugriff. Jede ist ein Tool der ersten Klasse, das über tools/list erkannt werden kann.
Tools degenerieren elegant. Wenn die SkySpark-Verbindung unterbrochen ist, funktionieren die Such- und Analyse-Tools weiterhin offline gegen den lokalen Index.
Funktionsanalyse
Bidirektional von Grund auf
findFunctionUsage findet alle Aufruforte. getFunctionCallGraph erstellt den Abhängigkeitsbaum – wer ruft diese Funktion auf und was ruft sie auf – in einem Durchgang. getFunctionUsageStats aggregiert die gesamte Codebasis.
Die Indizierung läuft inkrementell ab. Speichern Sie eine Datei, der Graph wird aktualisiert. Jede Funktion in Ihrer Axon-Codebasis wird mit ihrem vollständigen Kontext abfragbar.
- ✓ Aufrufer-Auflösung über Kits hinweg
- ✓ Aufgerufene-Auflösung mit Tiefenlimit
- ✓ Erkennung ungenutzter Funktionen
- ✓ Am häufigsten aufgerufene Funktions-Statistiken
Code-Generierung
Generieren, parsen, validieren – jedes Mal
generateAxonCode synthetisiert typisiertes Axon aus einem natürlichsprachigen Intent. parseAxonAst durchläuft das Ergebnis. validateAxonCode prüft Semantik, Operatoren und Typen gegen die indizierte Standardbibliothek. Nur validierte Ausgabe erreicht den Assistenten.
Die Schleife läuft in einem Tool-Aufruf ab. Falls die Validierung fehlschlägt, zeigt der Server den spezifischen Regel-Verstoß auf, damit der Assistent reparieren und erneut versuchen kann.
{ "pattern": "täglicher Energie-Rollup", "projectContext": "building-a" }
| Standort | Ausrüstung | Wert |
|---|---|---|
| campus-main | ahu-1 | 72.3°F |
| campus-main | ahu-2 | 74.1°F |
| campus-main | zone-core | 71.8°F |
Multi-Instanz-Authentifizierung
Von Wissen zu Aktion
OAuth 2.1-Token für jede SkySpark-Instanz. listSkySparkProjects entdeckt sie. switchSkySparkProject bindet die aktive. executeAxonCode führt dagegen aus.
Token befinden sich in SQLite über Prisma. Die Aktualisierung erfolgt automatisch. Sicherung und Wiederherstellung sind integriert, daher bedeutet der Wechsel zwischen Laptops nicht, zehn Gebäude neu zu authentifizieren.
Tech-Stack
Architektur
Funktionen
- ~20 MCP-Tools – über Suche, Code-Generierung, AST-Parsing, Aufrusgraph-Analyse und Live-Ausführung
- FlexSearch-Index – 4.187+ HTML-Dokumentationsdateien mit Abfrage-Latenz unter 50ms, 24-Stunden-Cache-TTL, 50-100 MB Footprint
- Tree-sitter AST –
web-tree-sitter0.26.5 für Axon-Parsing mit Operator-spezifischer Tokenisierung - Bidirektionale Aufrusgraphen – gespeichert in SQLite über Prisma; Aufrufer und aufgerufene Funktionen in beide Richtungen
- Typisierte Code-Generierung – mit Vorvalidierung vor der Rückgabe an den Client
- OAuth 2.1 Multi-Instanz – SkySpark-Authentifizierung für Live-Axon-Ausführungs-Tools
- Next.js Dashboard – und verpackte VSCode-Erweiterung (
.vsix) für Developer-Workflow - Transporte – stdio (lokal) und HTTP (remote / Multi-Client)
Indizierte Kategorien
HLK, Energie, Meter, Berichterstellung, Admin, Spark-Analyse, Sensor, Steuerung, Datenanalyse, Dienstprogramme
Anforderungen
- Node.js 18+
- Axon-Code- und Dokumentationspfade (konfiguriert über
axon-config.json) - SkySpark 3.0+ für Live-Ausführungs-Tools
- 8 GB RAM empfohlen (
--max-old-space-size=8192)
Interesse an diesem Projekt?
Erkunde den Quellcode, trage bei oder nimm Kontakt auf.