Axon MCP Server
Eine KI-abfragbare Bibliothek von Axon-Wissen
Geben Sie KI-Assistenten Expertenzugriff auf Ihre Axon-Codebasis.
Axon MCP Server indexiert Tausende von Axon-Funktionen, Operator-Verwendungen und SkySpark-Dokumentationsseiten in eine durchsuchbare Bibliothek und macht sie über das Model Context Protocol zugänglich. Jeder MCP-kompatible Assistent – Claude Desktop, Cursor, benutzerdefinierte Tools – kann Ihr Axon-Wissen so abfragen, wie es ein Senior Engineer tun würde: nach Operatoren suchen, Verwendungsbeispiele abrufen, Call Graphs nachverfolgen, typisierten Code generieren und vor der Ausführung validieren.
Indexieren 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, wunderbare – und die meisten LLMs haben sie 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 Wissensschicht: Jeder Vorschlag stammt aus echtem indexiertem Code, jede generierte Funktion ist vorab validiert, und jeder Call Graph ist bidirektional.
Für wen es ist
- SkySpark-Entwickler, die HVAC-, Energie- und Sparks-Logik schreiben und einen echten KI-Pair-Programmer möchten
- Building-Automation-Integratoren, die Wissen über Dutzende von Axon-Projekten zusammentragen
- Berater, die eine neue Axon-Codebasis eines Kunden onboarden und schnelle Navigation benötigen
Durchsuchen Sie 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 dem Wochentag und dem 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. Berücksichtigt Belegungsgates und manuelle Übergabepunkte.
Rollup-Zone-Temperaturverlauf in Tagesdurchschnitte, typisiert auf °F oder °C basierend auf Website-Tag-Konventionen.
Berechnet eine wetternormalisierte Energie-Baseline für eine Website aus historischen Zählerdaten und Gradtag-Eingaben.
Schreibt einen neuen Sollwert in ein Punkt-Datensatz mit Prioritätshandling und Audit-Trail-Verlaufsmarkierungen.
MCP Tool Surface
Eine kompakte Schnittstelle, 20 spezialisierte Tools
Jedes Tool, das der Assistent benötigt, ist nur einen JSON-Aufruf entfernt. Der Server macht vier Gruppen verfügbar: Suche, Funktionsanalyse, Code-Generierung und Live-SkySpark-Zugriff. Jedes ist ein erstklassiges MCP-Tool, das über tools/list auffindbar ist.
Tools verschlechtern sich anmutig. Wenn die SkySpark-Verbindung unterbrochen ist, funktionieren die Such- und Analyse-Tools weiterhin offline gegen den lokalen Index.
Funktionsanalyse
Bidirektional von Natur aus
findFunctionUsage findet jede Aufrufstelle. getFunctionCallGraph erstellt den Abhängigkeitsbaum – wer diese Funktion aufruft und was sie aufruft – in einem einzigen Durchlauf. getFunctionUsageStats aggregiert die gesamte Codebasis.
Die Indizierung läuft inkrementell. 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
- ✓ Aufgerufenen-Auflösung mit Tiefenlimit
- ✓ Erkennung ungenutzter Funktionen
- ✓ Statistiken zu am häufigsten aufgerufenen Funktionen
Code-Generierung
Generieren, analysieren, validieren – jedes Mal
generateAxonCode synthetisiert typisierten Axon-Code aus einer natürlichsprachigen Absicht. parseAxonAst durchläuft das Ergebnis. validateAxonCode überprüft die Semantik, Operatoren und Typen gegen die indizierte Standardbibliothek. Nur validierter Output erreicht den Assistenten.
Die Schleife läuft in einem Tool-Aufruf. Bei Validierungsfehlern gibt der Server die spezifische Regelverletzung an, damit der Assistent den Code reparieren und erneut versuchen kann.
{ "pattern": "daily energy rollup", "projectContext": "building-a" }
| site | equip | val |
|---|---|---|
| campus-main | ahu-1 | 72.3°F |
| campus-main | ahu-2 | 74.1°F |
| campus-main | zone-core | 71.8°F |
Multi-Instanz-Authentifizierung
Vom Wissen zur Tat
OAuth 2.1-Token für jede SkySpark-Instanz. listSkySparkProjects ermittelt sie. switchSkySparkProject bindet die aktive. executeAxonCode führt dagegen aus.
Token werden in SQLite via Prisma gespeichert. Aktualisierung erfolgt automatisch. Sicherung und Wiederherstellung sind integriert, sodass der Wechsel zwischen Laptops nicht bedeutet, zehn Gebäude erneut zu authentifizieren.
Tech-Stack
Architektur
Funktionen
- ~20 MCP Tools – über Suche, Code-Generierung, AST-Analyse, Call-Graph-Analyse und Live-Ausführung verteilt
- FlexSearch Index – 4.187+ HTML-Dokumentationsdateien mit Abfragelatenz unter 50ms, 24-Stunden-Cache-TTL, 50-100 MB Footprint
- Tree-sitter AST –
web-tree-sitter0.26.5 für Axon-Parsing mit operatorspezifischer Tokenisierung - Bidirektionale Call Graphs – gespeichert in SQLite via Prisma; Aufrufer und Aufgerufene in beide Richtungen
- Typisierte Code-Generierung – mit Vorab-Validierung vor Rückgabe an den Client
- OAuth 2.1 Multi-Instanz – SkySpark-Authentifizierung für Live-Axon-Ausführung
- Next.js Dashboard – und verpackte VSCode-Erweiterung (
.vsix) für Developer Workflow - Transports – stdio (lokal) und HTTP (remote / Multi-Client)
Kategorien indiziert
HVAC, Energie, Meter, Berichterstattung, 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-Execution Tools
- 8 GB RAM empfohlen (
--max-old-space-size=8192)
Interesse an diesem Projekt?
Erkunde den Quellcode, trage bei oder nimm Kontakt auf.