UI5 MCP Server

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.

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.

Server per npx -y @ui5/mcp-server als stdio-Prozess starten und in der MCP-Client-Konfiguration eintragen, z. B. über claude mcp add --transport stdio --scope user ui5-mcp-server -- npx -y @ui5/mcp-server in Claude Code oder den analogen codex mcp add-Befehl in Codex. Alternativ direkt aus der GitHub-MCP-Server-Registry installieren.

npx -y @ui5/mcp-server

Keine Authentifizierung erforderlich; der Server läuft als lokaler stdio-Prozess auf dem Rechner der entwickelnden Person und wird nicht über das Netzwerk exponiert.

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.

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.

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.