Sedona MCP Server
Unified Multi-Protocol Access to Sedona, Sandstar, and SkySpark
Ein MCP-Server, vier Gebäudeautomationsprotokolle, null Verbindungscode.
Sedona MCP Server spricht Sedona Sox über binäres TCP auf Port 1876, Sedona Weblet über HTTP auf 8085, Sandstars Project Haystack Bridge und SkySpark über HTTPS – alles hinter einer einheitlichen MCP-Werkzeugoberfläche. Bitten Sie es, Sedona-Klassen zu durchsuchen, Komponentencode zu generieren oder Live-Axon gegen ein laufendes SkySpark-Projekt auszuführen, und die Protokoll-Routing-Schicht ermittelt automatisch, welches Transport-Medium zu verwenden ist.
Offline indiziert es 27+ Werkzeuge mit Sedona-Beispielen, Kits, Klassen, Mustern und Vorlagen mit FlexSearch. Online erreicht es echte Gebäude.
Warum es existiert
Ein moderner Steuerungsstapel ist nicht ein Protokoll – es sind vier, manchmal fünf. Ingenieure jonglieren mit separaten Werkzeugen für jedes und verlieren den Kontext bei jedem Wechsel. Sedona MCP Server reduziert das auf ein Gespräch: Der Assistent fragt executeAxonCode und der Server kümmert sich um HTTPS plus SCRAM-Handshake mit SkySpark; er fragt searchSedonaClasses und der Server nutzt den lokalen Index; er fragt getActiveConnection und der Server meldet, welches Gerät aktuell gebunden ist.
Für wen es gedacht ist
- Steuerungsingenieure, die über Sedona-Geräte und SkySpark-Projekte auf derselben Baustelle arbeiten
- Sandstar-Entwickler, die Haystack-Tags mit Sedona-Hardware verbinden
- KI-gestützte Integratoren, die einen MCP-Server statt vier möchten
Protokoll-Schaltpult
Vier Protokolle, ein MCP-Werkzeugaufruf
Eine Konfigurationsdatei definiert Ihre Sox-Geräte, Weblet-Server, Sandstar-Bridges und SkySpark-Instanzen. Jeder Werkzeugaufruf wird zum richtigen Transport geroutet – binäres TCP, HTTP, HTTPS – ohne eine einzige Zeile Verbindungscode.
Werkzeugoberflläche
Sechs Bereiche, eine Schnittstelle
Suchen, generieren, validieren, analysieren, ausführen, verbinden. Siebenundzwanzig-plus Werkzeuge organisiert nach dem Vorgang, den Sie ausführen – nicht nach dem Protokoll, das Sie verwenden.
Der Assistent muss das Drahtformat nicht kennen. Er wählt das Werkzeug für die Aufgabe. Der Router ruft das richtige Ziel auf.
Live-Verbindungen
Vier Schienen, ein Dashboard
Jede Verbindung wird unabhängig überwacht. getActiveConnection meldet, welches Protokoll zuletzt verwendet wurde. discoverInstanceProjects durchläuft alles Erreichbare. clearProjectCache setzt zurück, wenn etwas abweicht.
Die Konfigurationsdatei ist die einzige Quelle der Wahrheit. Fügen Sie eine neue SkySpark-Instanz hinzu, fügen Sie ein neues Sedona-Gerät hinzu, ändern Sie einen Port – der Router liest beim nächsten Werkzeugaufruf erneut.
SkySpark-Ausführung
Vom Katalog ins Gebäude
executeAxonCode führt beliebiges Axon gegen das aktuell gebundene SkySpark-Projekt aus. listSkySparkProjects und switchSkySparkProject lassen Sie über Instanzen roamen. discoverProjectFunctions introspiziert; getProjectSchema gibt das Datenmodell zurück.
Projektzustand bleibt erhalten. Schalten Sie einmal um, und die nächsten 50 Werkzeugaufrufe gehen zum selben Gebäude. Schalten Sie zurück, und der Cache war bereit.
| dis | zone | val | ts |
|---|---|---|---|
| Zone 101 | core-1 | 72,3°F | 10:12 |
| Zone 102 | core-1 | 74,1°F | 10:12 |
| Zone 103 | core-1 | 71,8°F | 10:12 |
| Zone 201 | core-2 | 73,4°F | 10:12 |
| Zone 202 | core-2 | 72,9°F | 10:12 |
Sedona-Geräte
Erstklassige Introspektion auf der binären Schiene
listSedonaKits durchläuft das Gerätemanifest. getActiveConnection meldet den gebundenen Host. discoverInstanceProjects koppelt automatisch entdeckte Geräte mit ihrem Projektkontext. Sox wird als Peer von HTTP behandelt, nicht als Alttransport.
Binär bedeutet nicht undurchsichtig. Jede Klasse, jedes Kit, jede Firmware-Version ist für den Assistenten sichtbar – und durchsuchbar.
Tech-Stack
Architektur
Funktionalität
- 27+ MCP-Werkzeuge – organisiert nach Bereich: Sedona-Suche, Code-Generierung, Funktionsanalyse, SkySpark-/Axon-Ausführung, Geräte-/Verbindungsverwaltung, Haystack-Abfragen
- Multi-Protokoll-Routing – Sedona Sox (binäres TCP 1876), Sedona Weblet (HTTP 8085), Sandstar Haystack Bridge, SkySpark HTTPS 443 mit SCRAM-Authentifizierung
- FlexSearch-indiziert – Sedona-Beispiele, Betreiberbeispiele, Dokumentation, Klassen, Kits, Vorlagen und Muster für Offline-Abfragen
- Code-Generierung und -Validierung –
generateSedonaCodeundvalidateSedonaCodemit Kit-bewussten Vorlagen - Bidirektionale Aufrufgraph- und Nutzungsanalyse – über eine Sedona-Codebasis
- Live-SkySpark- und Axon-Ausführung – mit Projektumschaltung und Pro-Instanz-Projekt-Caching
- YAML- und JSON-Konfiguration –
config/connections.jsonfür deklarative Verbindungsdefinitionen pro Protokoll
Meilenstein v2.0.0
Ausbau von nur-Axon (v1.x) zu einem Multi-Protokoll-Unified-Server: Sedona Sox plus Weblet plus Sandstar plus SkySpark.
Anforderungen
- Node.js 18+
config/connections.jsongefüllt für jedes verwendete Protokoll- Netzwerkerreichbarkeit zu Sox-Geräten (TCP 1876), Weblet/Sandstar (HTTP 8085) und/oder SkySpark (HTTPS 443)
Interesse an diesem Projekt?
Erkunde den Quellcode, trage bei oder nimm Kontakt auf.