Sedona MCP Server
Multi-Protokoll-Einheitlicher Zugriff auf Sedona, Sandstar und SkySpark
Ein MCP-Server, vier Gebäudeautomationsprotokolle, null Glue-Code.
Sedona MCP Server spricht Sedona Sox über binäres TCP an Port 1876, Sedona Weblet über HTTP an 8085, Sandstars Project-Haystack-Bridge und SkySpark über HTTPS – alles hinter einer einheitlichen MCP-Werkzeugoberfläche. Fordern Sie ihn auf, Sedona-Klassen zu durchsuchen, Komponentencode zu generieren oder Live-Axon gegen ein laufendes SkySpark-Projekt auszuführen, und die Protokoll-Routing-Schicht ermittelt, welchen Transport zu nutzen ist.
Offline indiziert es 27+ Werkzeuge von 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 jedes Mal, wenn sie wechseln. Sedona MCP Server reduziert das auf ein Gespräch: Der Assistent fragt executeAxonCode und der Server kümmert sich um HTTPS plus SCRAM-Handshake zu SkySpark; er fragt searchSedonaClasses und der Server durchsucht den lokalen Index; er fragt getActiveConnection und der Server meldet, welches Gerät derzeit gebunden ist.
Für wen es ist
- Steuerungsingenieure, die über Sedona-Geräte und SkySpark-Projekte auf demselben Job arbeiten
- Sandstar-Entwickler, die Haystack-Tags zu Sedona-Hardware verbinden
- KI-gestützte Integratoren, die einen MCP-Server möchten, nicht vier
Protokoll-Vermittlung
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 weitergeleitet – binäres TCP, HTTP, HTTPS – ohne eine einzige Zeile Glue-Code.
Tool-Oberfläche
Sechs Bereiche, eine Schnittstelle
Suchen, generieren, validieren, analysieren, ausführen, verbinden. Siebenundzwanzig-plus Werkzeuge, organisiert nach der Operation, die Sie ausführen – nicht nach dem Protokoll, das Sie nutzen.
Der Assistent muss das Drahtformat nicht kennen. Er wählt das Werkzeug für die Aufgabe aus. Der Router wählt das richtige Ziel.
Live-Verbindungen
Vier Schienen, ein Dashboard
Jede Verbindung wird unabhängig verffolgt. getActiveConnection meldet, welches Protokoll zuletzt verwendet wurde. discoverInstanceProjects durchsucht, was erreichbar ist. 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 derzeit gebundene SkySpark-Projekt aus. listSkySparkProjects und switchSkySparkProject ermöglichen es Ihnen, über Instanzen zu navigieren. discoverProjectFunctions introspiziert; getProjectSchema gibt das Datenmodell zurück.
Der Projektzustand bleibt erhalten. Wechseln Sie einmal, und die nächsten 50 Werkzeugaufrufe gehen an denselben Bau. Wechseln 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
Introspektive Klasse auf der Binärschiene
listSedonaKits durchsucht das Gerätemanifest. getActiveConnection meldet den gebundenen Host. discoverInstanceProjects koppelt automatisch entdeckte Geräte mit ihrem Projektkontext. Sox wird als ein Gleichgestellter von HTTP behandelt, nicht als Legacy-Transport.
Binär bedeutet nicht undurchsichtig. Jede Klasse, jedes Kit, jede Firmware-Version ist für den Assistenten sichtbar – und durchsuchbar.
Tech-Stack
Architektur
Funktionen
- 27+ MCP-Werkzeuge – organisiert nach Anliegen: 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, Operator-Beispiele, Dokumente, Klassen, Kits, Vorlagen und Muster für Offline-Abfragen
- Code-Generierung und Validierung –
generateSedonaCodeundvalidateSedonaCodemit Kit-bewussten Vorlagen - Bidirektionale Call-Graph- und Nutzungsanalyse – über eine Sedona-Codebasis
- Live-SkySpark- und Axon-Ausführung – mit Projekt-Umschaltung und Projekt-Zwischenspeicherung pro Instanz
- 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-einheitlichen Server: Sedona Sox plus Weblet plus Sandstar plus SkySpark.
Anforderungen
- Node.js 18+
config/connections.jsonfür jedes verwendete Protokoll gefüllt- 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.