Unreal MCP

Unreal MCP ist das Unreal-Engine-Plugin von AI Game Developer. Es ermöglicht einem KI-Agenten wie Claude Code, Cursor, GitHub Copilot, Codex oder Gemini, direkt im Unreal Editor zu arbeiten: Actors, Komponenten, Assets und Level abfragen und ändern, Blueprints erstellen und kompilieren, C++ bearbeiten und kompilieren, Editor-Python ausführen und Screenshots aufnehmen, die er sich ansehen kann. Du beschreibst in natürlicher Sprache, was du möchtest, und der Agent ruft die Werkzeuge des Editors über das Model Context Protocol (MCP) auf.

Dieses Wiki erklärt, wie du das Plugin installierst, deinen KI-Client verbindest und mit KI im Unreal Editor brauchbare Ergebnisse erzielst. Das Plugin befindet sich in der Beta; die aktuelle Version ist 0.26.2.

Wie die Teile zusammenpassen#

Ein Unreal MCP-Setup besteht aus vier Teilen. Wenn du sie kennst, werden Einrichtung und Fehlersuche deutlich einfacher.

• Das Unreal MCP-Plugin (UnrealMCP). Ein C++-Editor-Plugin, das im Ordner Plugins/ deines Projekts installiert wird. Es registriert die KI-Werkzeuge und fügt das Fenster AI Game Developer zum Editor hinzu.
• Die Bridge (unreal-mcp-bridge). Der Unreal Editor ist in C++ geschrieben, daher läuft der .NET-MCP-Host als kleiner Hilfsprozess neben dem Editor. Das Plugin startet ihn automatisch und kommuniziert über eine lokale, token-geschützte Verbindung mit ihm. In einem gepackten Release ist die Bridge enthalten, du musst also kein .NET installieren.
• Der MCP-Server. Standardmäßig verbindet sich die Bridge mit dem gehosteten Server unter ai-game.dev (Cloud-Modus). Alternativ kannst du den gemeinsamen lokalen Server gamedev-mcp-server auf deinem eigenen Rechner ausführen (Custom-Modus).
• Dein KI-Client. Jeder MCP-Client verbindet sich mit demselben Server und erreicht darüber deinen Editor.

Zwei Werkzeuge helfen dir bei der Einrichtung:

• AI Game Dev, die Desktop-App, installiert das Plugin für dich in ein Unreal-Projekt und kann den Editor öffnen. Node.js ist nicht erforderlich. Siehe das App-Wiki.
• unreal-mcp-cli, ein plattformübergreifendes Kommandozeilenwerkzeug auf npm. Es installiert und aktualisiert das Plugin, meldet dich an, schreibt MCP-Client-Konfigurationen, öffnet den Editor und führt Werkzeuge von einem Terminal oder aus CI aus.

Was der KI-Agent tun kann#

Das Plugin enthält 27 Werkzeuge in 7 Familien. Die meisten Editor-Daten laufen über RQL, eine Abfragesprache für den gesamten Editor, statt über ein eigenes Werkzeug pro Operation:

• RQL (rql-query, rql-mutate, rql-schema): Actors, Komponenten, Assets, Level, DataTables, Gameplay-Tags, Project Settings, Blueprint-Graphen, Widget Blueprints und Level Sequences finden und ändern.
• Blueprints: Blueprints erstellen, bearbeiten und kompilieren, mit einer strukturierten Fehlerliste, die der Agent beheben kann.
• C++-Quellcode: Projekt-C++ lesen, anlegen, bearbeiten und kompilieren (Live Coding oder Unreal Build Tool).
• Python: Python mit der vollständigen unreal-Editor-API ausführen.
• Screenshots: Aufnahmen aus Viewport, Spielansicht, Kamera und von isolierten Actors.
• Console- und Werkzeuglisten-Helfer.

Sechs optionale Erweiterungen ergänzen Unterstützung für Control Rig, Enhanced Input, Gameplay Ability System, Landscape und Water, Niagara und PCG. Du kannst auch eigene Werkzeuge aus jedem beliebigen Unreal-Plugin registrieren.

Wiki-Seiten#

Wie es weitergeht#

• Neu hier? Beginne mit Installation und dann mit Erste Schritte.
• Du möchtest die Kurzfassung? Die Unreal Engine-Installationsseite und der Schnellstart decken das Wesentliche ab.
• Sie suchen Details zu den Tools? Durchsuchen Sie den Unreal-Toolkatalog und die Unreal-Best-Practices.
• Verwenden Sie auch eine andere Engine? Siehe das Unity-Wiki und das Godot-Wiki. Alle drei Plugins nutzen denselben Server, dasselbe Konto und dieselben AI-Clients.