UI5 MCP Server
Offizieller SAP-Server, der KI-Agenten UI5-Projekte scaffolden, API-Referenzen nachschlagen, Best Practices abrufen und Code per Linter/Manifest-Validierung prüfen lässt.
- Skill Road
- UI5 MCP Server
Kategorien
Beschreibung
Der UI5 MCP Server ist ein offizielles Werkzeug von SAP für die Entwicklung mit SAPUI5 und OpenUI5, dem verbreiteten JavaScript-Framework für Unternehmensanwendungen mit einheitlicher, barrierefreier Oberfläche. Er verbindet KI-Coding-Agenten über das Model Context Protocol mit framework-spezifischem Wissen, das sonst nur in Dokumentation, Styleguides und internen Tools steckt, und schließt damit eine Lücke, die generische Coding-Assistenten bei einem so spezialisierten, Konventionen-lastigen Framework typischerweise haben: Ohne dieses Wissen erzeugen Agenten leicht Code, der zwar syntaktisch funktioniert, aber gegen UI5-Konventionen für Datenbindung, Modularität oder Manifest-Struktur verstößt.
Verfügbare Werkzeuge
Das Repository listet zehn MCP-Tools. create_ui5_app gerüstet neue UI5-Anwendungen aus vordefinierten Vorlagen, create_integration_card erzeugt neue UI Integration Cards. get_api_reference liefert formatierte UI5-API-Dokumentation, get_guidelines sowie get_integration_cards_guidelines geben Zugriff auf offizielle Entwicklungs-Best-Practices, und get_typescript_conversion_guidelines unterstützt bei der Migration von JavaScript- zu TypeScript-Projekten. get_project_info extrahiert Metadaten und Konfiguration aus einem bestehenden UI5-Projekt, get_version_info liefert Versionsinformationen zum Framework. Zur Qualitätssicherung dienen run_manifest_validation, das die App-Manifest-Datei gegen das offizielle UI5-Schema prüft, sowie run_ui5_linter, das den bereits etablierten @ui5/linter einbindet und Probleme im Code direkt zurückmeldet.
Installation und Einrichtung
Der Server läuft ausschließlich lokal als stdio-Prozess, es gibt keinen von SAP gehosteten Remote-Endpunkt. Voraussetzung sind Node.js ab Version 20.17.0 beziehungsweise 22.9.0 sowie npm ab Version 8. Die Standardeinrichtung erfolgt über npx -y @ui5/mcp-server, wahlweise lässt sich der Server auch direkt aus der GitHub-MCP-Server-Registry installieren. Claude Code bietet dafür den Kurzbefehl claude mcp add --transport stdio --scope user ui5-mcp-server -- npx -y @ui5/mcp-server, für Codex existiert ein analoger codex mcp add-Befehl. Für native Windows-Umgebungen außerhalb von WSL empfiehlt die Dokumentation, npx zusätzlich über cmd /c aufzurufen.
Konfiguration und Sicherheit
Über Umgebungsvariablen lässt sich der Server feinjustieren: UI5_MCP_SERVER_ALLOWED_DOMAINS begrenzt standardmäßig auf localhost und services.odata.org, welche Domains von den Werkzeugen angesprochen werden dürfen, und kann projektspezifisch erweitert werden. UI5_MCP_SERVER_CDN_URL erlaubt es, die Quelle für UI5-Ressourcen umzuleiten, standardmäßig sdk.openui5.org für OpenUI5 beziehungsweise ui5.sap.com für SAPUI5. Weitere Variablen steuern Logging-Level, Datenverzeichnis für zwischengespeicherte API-Referenzen sowie das Abschalten von strukturierten Inhalten oder MCP-Resources für Clients, die diese nicht unterstützen, etwa Cursor oder die Gemini CLI.
SAPUI5 und OpenUI5
Das npm-Paket beschreibt sich selbst als "MCP server for SAPUI5/OpenUI5 development" und deckt damit beide Varianten desselben Frameworks ab: das quelloffene OpenUI5 sowie das kommerzielle SAPUI5, das zusätzliche, SAP-spezifische Steuerelemente und Themes für Business-Anwendungen mitbringt. Für welche Variante ein Projekt konfiguriert ist, erkennt der Server automatisch über get_project_info und passt CDN-Quelle sowie API-Referenzen entsprechend an.
Für wen sich der UI5 MCP Server lohnt
Der Server richtet sich an Teams, die bereits produktiv mit SAPUI5 oder OpenUI5 arbeiten und KI-Agenten beim Erstellen neuer Views, Controller und Fragmente enger an offizielle Konventionen binden wollen, statt generischen, framework-unwissenden Code zu erhalten. Besonders nützlich ist er bei TypeScript-Migrationen bestehender UI5-Anwendungen sowie beim Einstieg in UI Integration Cards, wo die eingebauten Guideline-Werkzeuge direkt auf offizielle Dokumentation statt auf das oft veraltete Trainingswissen des Modells zurückgreifen. Teams außerhalb des SAP-Ökosystems finden im Katalog mit dem Storybook MCP Server ein vergleichbares, aber framework-übergreifendes Werkzeug für Komponentenbibliotheken.
Voraussetzungen
Node.js Version 20.17.0 oder 22.9.0 (bzw. neuer), npm ab Version 8, ein bestehendes UI5-Projekt (SAPUI5 oder OpenUI5) sowie ein MCP-fähiger Client wie Claude Code, Codex, Cursor oder VS Code Copilot.
Installationsanleitung
Der UI5 MCP Server läuft als lokaler stdio-Prozess und lässt sich in wenigen Schritten mit einem MCP-fähigen Client verbinden.
Schritt 1: Voraussetzungen
Installiere Node.js in Version 20.17.0 oder 22.9.0 (oder neuer) sowie npm ab Version 8. Ein bestehendes UI5-Projekt ist nicht zwingend nötig – create_ui5_app kann auch ein neues Projekt von Grund auf gerüsten.
Schritt 2: Server mit dem Client verbinden
Für die meisten MCP-Clients funktioniert die Standardkonfiguration mit npx -y @ui5/mcp-server als stdio-Befehl. Claude-Code-Nutzer richten den Server direkt über die CLI ein:
claude mcp add --transport stdio --scope user ui5-mcp-server -- npx -y @ui5/mcp-server
Für Codex existiert der analoge Befehl codex mcp add --transport stdio ui5-mcp-server -- npx -y @ui5/mcp-server. VS Code bietet zusätzlich die Installation direkt aus der GitHub-MCP-Server-Registry. Unter nativem Windows (außerhalb von WSL) muss npx gegebenenfalls über cmd /c aufgerufen werden, da der Prozessaufruf sonst fehlschlagen kann.
codex mcp add --transport stdio ui5-mcp-server -- npx -y @ui5/mcp-server
Projektkonventionen für den Agenten hinterlegen
Damit ein Agent den Server auch von sich aus nutzt, empfiehlt die offizielle Dokumentation, eine kurze Regel in die projektweite AGENTS.md beziehungsweise CLAUDE.md aufzunehmen: den Agenten anzuweisen, vor UI5-spezifischen Aufgaben zunächst get_guidelines aufzurufen, um aktuelle Coding-Standards abzurufen, statt sich auf möglicherweise veraltetes Trainingswissen zu verlassen.
Schritt 3: Erste Schritte mit dem Agenten
Für ein neues Projekt lässt sich der Agent bitten, create_ui5_app mit einer passenden Vorlage aufzurufen. In einem bestehenden Projekt liefert get_project_info zunächst einen Überblick über Framework-Variante (SAPUI5 oder OpenUI5) und Version. Vor größeren Änderungen lohnt sich ein Blick in get_api_reference für die betroffenen Steuerelemente, und nach Abschluss einer Änderung prüfen run_ui5_linter und run_manifest_validation, ob der erzeugte Code den offiziellen Konventionen entspricht.
Schritt 4: Konfiguration anpassen
Reicht die Standard-Domainliste (localhost, services.odata.org) nicht aus, weil das Projekt zusätzliche OData-Services einbindet, lässt sich UI5_MCP_SERVER_ALLOWED_DOMAINS als Umgebungsvariable in der Client-Konfiguration um weitere Domains ergänzen. Wer ausschließlich mit SAPUI5 statt OpenUI5 arbeitet, muss in der Regel nichts anpassen – der Server erkennt die Framework-Variante automatisch aus der Projektkonfiguration und wählt die passende CDN-Quelle.
Typische Stolperfallen
Fehlt eine unterstützte Node.js-Version, startet der Server gar nicht erst; ein node --version-Check vor der Einrichtung erspart unnötige Fehlersuche. Wird eine externe Domain für API-Aufrufe benötigt, die nicht in der Allowlist steht, schlagen die betroffenen Werkzeuge fehl, bis die Domain ergänzt wurde. Da der Server rein lokal läuft, funktioniert er nicht als gemeinsam genutzter Team-Endpunkt – jede entwickelnde Person richtet ihn einzeln auf der eigenen Maschine ein.
node --version
Schritt 5: Im Team einheitlich einrichten
Weil jede Person den Server lokal selbst startet, lohnt es sich, die Client-Konfiguration (etwa den claude mcp add-Befehl oder den entsprechenden Eintrag für Codex/Cursor) zusammen mit der AGENTS.md-Regel zum Aufruf von get_guidelines im Projekt-Repository zu dokumentieren, statt sie nur mündlich weiterzugeben. So starten neue Teammitglieder mit derselben Konfiguration und demselben Agentenverhalten, ohne dass sich abweichende lokale Einstellungen einschleichen und zu inkonsistentem, teils gegen die UI5-Konventionen verstoßendem Code führen.
claude mcp add
npx -y @ui5/mcp-server
Authentifizierung
Keine Authentifizierung erforderlich; der Server läuft als lokaler stdio-Prozess auf dem Rechner der entwickelnden Person und wird nicht über das Netzwerk exponiert.
Benötigte Zugriffsrechte
Lesezugriff auf das lokale UI5-Projektverzeichnis (Quellcode, Manifest, Konfiguration) sowie Netzwerkzugriff auf die per UI5_MCP_SERVER_ALLOWED_DOMAINS erlaubten Domains (standardmäßig localhost und services.odata.org) zum Abruf von API-Referenzen und Framework-Ressourcen.
Übertragene oder gespeicherte Daten
Projektcode, Manifest-Inhalte und über die Tools abgerufene API-Referenzen werden an den verbundenen KI-Agenten und dessen Modell-Provider übertragen. Der Server selbst läuft lokal und sendet keine Daten an SAP; API-Referenzen werden von den konfigurierten CDN-Domains (Standard sdk.openui5.org bzw. ui5.sap.com) abgerufen und lokal zwischengespeichert.
Sicherheitsrisiken
Die Domain-Erlaubnisliste (UI5_MCP_SERVER_ALLOWED_DOMAINS) sollte nicht leichtfertig auf alle Domains geöffnet werden, da Tools sonst beliebige externe Adressen ansprechen könnten. Enthält das UI5-Projekt reale Kundendaten in Konfigurationsdateien oder Beispieldaten, gelangen diese über den Agenten an dessen Modell-Provider; für sensible SAP-Projekte empfiehlt sich, den Kontext bewusst auf anonymisierte Beispiele zu beschränken.
Lizenz und Kosten
- Lizenz
- Apache-2.0
- Kosten
- kostenlos
Der Server ist Teil des Apache-2.0-lizenzierten UI5-Tooling-Ökosystems und vollständig kostenlos nutzbar, ohne Konto oder Abonnement. Für SAPUI5-spezifische Steuerelemente kann ein bestehender SAP-Lizenzvertrag Voraussetzung sein; das MCP-Werkzeug selbst verursacht keine zusätzlichen Kosten.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- SAP
- Status
- Offizieller Server
- Betriebsart
- Lokal
- Aktuelle Version
- 0.2.20
- GitHub-Sterne
- 104
- Zuletzt geprüft
- 16.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.