NAJEMWEHBE/UnrealClaudeMCP

Was macht UnrealClaudeMCP?

Steuere die Unreal Engine 5 von jedem MCP-kompatiblen Client (Claude Code, Codex CLI, Cursor, Gemini CLI, …) über lokales MCP – 59 Editor-Automatisierungswerkzeuge, ~50 ms Roundtrip. MIT-lizenziert.

Installation

1. Installiere das Plug-in in Unreal Engine 5:

   • Öffne dein Projekt in der Unreal Engine.
   • Gehe zu Bearbeiten → Plug-ins.
   • Suche nach „MCP“ im Plug-in-Browser.
   • Aktiviere das Plug-in Unreal Engine MCP.
   • Starte den Editor neu.

2. Konfiguriere deinen MCP-kompatiblen Client (z. B. Claude Code, Cursor, Codex CLI):

   • Füge die folgende Konfiguration zu deiner mcp.json-Datei (oder der entsprechenden Client-Konfiguration) hinzu:

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "npx",
      "args": ["-y", "@najemwehbe/unreal-mcp-client"],
      "env": {
        "UNREAL_ENGINE_WS_PORT": "8080"
      }
    }
  }
}

Nutzung

Sobald das Plug-in und der Client konfiguriert sind, kannst du die Unreal Engine über deinen KI-Assistenten steuern. Beispielaufforderungen:

• „Erstelle eine neue Materialinstanz namens M_Ground auf Basis von M_BaseColor.“
• „Kompiliere alle Blueprints im Ordner Content/Blueprints.“
• „Setze die Auflösung des Viewports auf 1920x1080.“
• „Füge dem aktuellen Level eine Point-Lichtquelle hinzu.“

Verfügbare Werkzeuge

Das Plug-in stellt standardmäßig folgende MCP-Tools bereit (Liste nicht abschließend):

• level_management – Level erstellen, laden, speichern, schließen
• actor_management – Actors platzieren, verschieben, löschen
• material_management – Materialien und Materialinstanzen erstellen, bearbeiten
• blueprint_compilation – Blueprints und C++-Code kompilieren
• viewport_management – Viewport-Einstellungen und Kamerasteuerung
• asset_management – Assets importieren, umbenennen, löschen, verschieben
• project_settings – Projekteinstellungen ändern
• editor_commands – Editor-Befehle ausführen (z. B. „Alle speichern“)

Eine vollständige Liste findest du in der Dokumentation des Plug-ins. Werkzeuge können je nach Version variieren.

Konfiguration

Umgebungsvariablen

Variable	Standardwert	Beschreibung
UNREAL_ENGINE_WS_PORT	8080	Der Port, auf dem der Unreal-MCP-Websocket lauscht

Client-Konfiguration

Je nach Client variiert die genaue Konfiguration. Beispiel oben (mcp.json) ist für Clients wie Claude Code, Cursor oder Codex CLI geeignet.

Fehlerbehebung

• Verbindung fehlgeschlagen: Stelle sicher, dass die Unreal Engine geöffnet ist und das Plug-in aktiviert wurde.
• Werkzeuge nicht verfügbar: Überprüfe, ob die Client-Konfiguration korrekt ist und der Port (8080) nicht von einem anderen Dienst belegt wird.
• Berechtigungsfehler: Führe den Unreal Editor als Administrator aus, wenn du auf geschützte Ordner zugreifen musst.

Lizenz

MIT-Lizenz – siehe LICENSE für Details.

Beitragen

Beiträge sind willkommen! Öffne ein Issue oder einen Pull-Request im GitHub-Repository.