Tutorials

Blender & Antigravity MCP: Vollständige Einrichtungsanleitung zur KI-gestützten 3D-Steuerung

Melden

Das Model Context Protocol (MCP) ermöglicht es modernen KI-Modellen (wie z. B. Claude), direkt mit lokalen Anwendungen zu interagieren. Durch das Antigravity MCP-Setup kannst du Blender über natürliche Sprache steuern, 3D-Szenen generieren lassen, Beleuchtungen anpassen oder komplexe Python-Skripte direkt per Prompt ausführen.

Diese Anleitung führt dich Schritt für Schritt durch die Installation und Konfiguration.

1. Voraussetzungen

Bevor du beginnst, stelle sicher, dass folgende Software auf deinem System installiert ist:

  • Blender (eine aktuelle Version)
  • Python (passend zu deiner Umgebung)
  • Node.js / npm (wird von vielen MCP-Server-Bridges vorausgesetzt)
  • Ein MCP-fähiger Client (z. B. die Claude Desktop App)
  • Ein Terminal / Befehlszeile (PowerShell, Terminal unter macOS/Linux)

2. Vorbereitung in Blender

Damit externe Skripte und KI-Modelle optimal mit Blender kommunizieren können, müssen die Entwickler-Optionen aktiviert sein.

  1. Öffne Blender.
  2. Gehe auf Edit > Preferences (Bearbeiten > Einstellungen).
  3. Wechsle zum Reiter Interface (Benutzeroberfläche).
  4. Setze einen Haken bei:
    • Developer Extras
    • Python Tooltips
  5. Gehe zum Reiter Save & Load und stelle sicher, dass Auto Run Python Scripts aktiviert ist (Vorsicht: Nur bei vertrauenswürdigen Projekten nutzen).
  6. Schließe die Einstellungen (sie speichern sich automatisch).

3. Installation des Antigravity MCP-Servers

Das Antigravity-Setup besteht in der Regel aus zwei Komponenten: Einem Listener/Add-on in Blender und dem eigentlichen MCP-Server, der mit deinem KI-Client spricht.

Schritt A: Server-Dateien vorbereiten

Klone oder lade das Antigravity MCP-Repository herunter:

git clone https://github.com/dein-repo/blender-antigravity-mcp.git
cd blender-antigravity-mcp

(Hinweis: Ersetze die URL durch den genauen Pfad deines Antigravity-MCP-Pakets oder erstelle den lokalen Projektordner).

Schritt B: Abhängigkeiten installieren

Führe im Ordner des MCP-Servers die Installation aus:

npm install
# ODER falls es sich um eine Python-basierte Bridge handelt:
pip install -r requirements.txt

4. MCP-Client konfigurieren (z. B. Claude Desktop)

Damit dein KI-Assistent weiß, wie er mit dem Blender-Server kommunizieren soll, muss er in der MCP-Konfigurationsdatei registriert werden.

  1. Öffne die Konfigurationsdatei deines MCP-Clients:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Füge den Antigravity-Server unter mcpServers hinzu:
{
  "mcpServers": {
    "blender-antigravity": {
      "command": "node",
      "args": [
        "ABSOLUTER/PFAD/ZU/blender-antigravity-mcp/build/index.js"
      ],
      "env": {
        "BLENDER_PORT": "9876",
        "BLENDER_HOST": "localhost"
      }
    }
  }
}

(Passe den Pfad sowie das Programm – node oder python – an deine tatsächliche Server-Datei an).

  1. Speichere die Datei und starte den MCP-Client komplett neu.

5. Verbindung herstellen

  1. Blender Listener starten:
    • Öffne Blender.
    • Öffne den Reiter Scripting und erstelle ein neues Textdokument.
    • Lade das Listener-Skript aus dem Antigravity-Ordner (meist blender_listener.py oder ähnlich) und klicke auf Run Script (Play-Button).
    • In der Systemkonsole von Blender siehst du nun eine Meldung wie:
      [Antigravity MCP] Server listening on localhost:9876.
  2. Client verbinden:
    • Sobald du deinen MCP-Client (z. B. Claude Desktop) öffnest, sollte das kleine Hammer-Icon (Tools) anzeigen, dass blender-antigravity verfügbar ist.

6. Erste Schritte & Test-Prompts

Du kannst der KI nun Befehle in natürlicher Sprache erteilen.

Beispiel-Prompts:

  • „Erstelle eine Szene mit einem Boden und drei schwebenden Kugeln mit glänzender Metalltextur (Antigravity-Look).“
  • „Lösche alle Standard-Objekte (Würfel, Kamera, Licht) und baue ein minimalistisches Studio-Setup auf.“
  • „Positioniere die Kamera so, dass sie von unten im 45-Grad-Winkel auf das Zentrum blickt und stelle die Brennweite auf 50mm.“
  • „Schreibe und führe ein Skript aus, das ein Torus-Knoten-Mesh generiert und ein Partikelsystem hinzufügt.“

7. Fehlerbehebung (Troubleshooting)

  • Port belegt / Verbindungsfehler:
    Falls Blender meldet, dass der Port (z. B. 9876) belegt ist, ändere den Port sowohl im Python-Listener-Skript in Blender als auch in der claude_desktop_config.json.
  • Tools werden im Client nicht angezeigt:
    Prüfe die absoluten Pfade in deiner JSON-Konfiguration. Nutze unter Windows vorzugsweise doppelte Backslashes (\\) oder normale Schrägstriche (/).
  • Blender friert ein:
    Achte darauf, dass das Socket-Skript in Blender im Hintergrund über einen sogenannten modal timer oder einen separaten Thread läuft, damit die GUI nicht blockiert wird.
0