[!IMPORTANT] Union ist veraltet. Verwenden Sie Unitys offiziellen MCP-Server.

Union ♾️ - Der Unity MCP-Server

Ein Model Context Protocol-Server für Unity

Hauptfunktionen

• 🖼️ Multimodale Bildverarbeitung: Ihr Agent kann sehen, was Sie sehen. Er kann die Szene betrachten, durch jede Kamera schauen, den Play-Modus beobachten und Asset-Vorschaubilder untersuchen.

• 🔎 Leistungsstarke Suche: Gehen Sie über das Projekt-Panel hinaus mit gleichzeitiger Suche in der Hierarchie und den Projekt-Assets.

• ✔️ Überlegene Code-Analyse: Nutzen Sie Unitys eigenen Compiler für eine Code-Analyse, die genauer ist als der Linter Ihres Agenten.

• ⏩ Schnellstart: Legen Sie in Sekunden mit einer einzigen mcp.json-Konfigurationsdatei los.

• 🛠️ Erweiterbar: Fügen Sie Ihre eigenen projektspezifischen Tools mit minimalem Boilerplate-Code hinzu.

• 📅 Immer aktuell: Auf dem neuesten Stand der MCP-Protokollversion gehalten — derzeit 2025-06-18 über das offizielle MCP C# SDK.

Related MCP server: Unity MCP Server

Kompatibilität

Einrichtung

1. Installieren Sie node.js

2. Konfigurieren Sie mcp.json

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@nurture-tech/unity-mcp-runner", "-unityPath", "<path to unity editor>", "-projectPath", "<path to unity project>"]
    }
  }
}

Dies installiert automatisch das Paket is.nurture.mcp in Ihrem Unity-Projekt. Sie können diese Änderungen gerne in die Versionsverwaltung einchecken.

Über die Tools

Lernen Sie Ihre Unity-KI-Toolbox kennen.

Bekannte Probleme

• Der Google External Dependency Manager (EDMU) führt dazu, dass Unity beim Starten über Cursor unter Windows hängen bleibt. Dies wird untersucht.

• Das Tool test_active_scene schlägt manchmal mit der Fehlermeldung Maximum call stack size exceeded. fehl.

• Das Tool search schlägt gelegentlich mit der Fehlermeldung Search index is not ready yet. Please try again later. fehl.

Hinzufügen projektspezifischer Tools

Union verwendet das offizielle C# MCP SDK.

1. Erstellen Sie eine statische Klasse, um Ihre Tools zu speichern. Fügen Sie die Annotation [McpServerToolType] zur Klasse hinzu.

2. Deklarieren Sie statische Methoden, um jedes Tool zu implementieren. Fügen Sie die Annotation [McpServerTool] zu jeder Methode hinzu.

3. Verweisen Sie auf das Verzeichnis Services für Beispiele.

4. Sie müssen wahrscheinlich Unity beenden und Ihren Agenten neu starten, damit er die neuen Tools erkennt.

Tipps zur Verwendung

Hier sind einige Tipps, um das Beste aus Union herauszuholen:

• 🚀 Starten Sie über Ihren Agenten: Starten Sie Unity immer über die MCP-Integration Ihres KI-Agenten. Das Starten von Unity über den Hub verhindert, dass sich der MCP-Server verbindet.

• 📂 Projektspezifische Einrichtung: Wenn Ihr Agent dies unterstützt, konfigurieren Sie den MCP-Server in Ihren projektspezifischen Einstellungen. Dies ermöglicht Ihnen den nahtlosen Wechsel zwischen Unity-Projekten.

• ⚙️ Befehlszeilenargumente: Sie können zusätzliche Argumente an Unity übergeben, für fortgeschrittene Szenarien wie das Ausführen im -batchmode oder -nographics für CI/CD-Pipelines. Fügen Sie ein ---Trennzeichen vor den Unity-spezifischen Argumenten hinzu:

  {
    "mcpServers": {
      "unity": {
        "command": "npx",
        "args": [
          "-y",
          "@nurture-tech/unity-mcp-runner"
          "-unityPath",
          "<path to unity editor>",
          "-projectPath",
          ".",
          "--",
          "-batchmode",
          "-nographics"
        ]
      }
    }
  }

• ⚠️ Wichtig: Verwenden Sie nicht das Befehlszeilenargument -logFile. Der MCP-Server ist für die Kommunikation auf die Standardausgabe von Unity angewiesen.

• 🖥️ Geteilter Bildschirm für Bildverarbeitung: Stellen Sie bei Tools wie screenshot sicher, dass der Unity-Editor auf Ihrem Bildschirm sichtbar ist, da er sonst das Fenster im Vordergrund aufnimmt.