Blender MCP mit Gemini CLI einrichten - Vollständige Anleitung

Einführung

Gemini CLI ist eine leistungsstarke Befehlszeilenschnittstelle, mit der Sie direkt vom Terminal aus mit Googles Gemini-KI-Modell interagieren können. Durch die Integration von Blender MCP mit Gemini CLI können Sie KI-Funktionen nutzen, um Ihren 3D-Modellierungsarbeitsablauf in Blender zu verbessern.

Diese Anleitung führt Sie durch den gesamten Einrichtungsprozess, vom Installieren von Node.js bis zur Überprüfung, ob Ihr MCP-Dienst ordnungsgemäß mit Gemini CLI funktioniert.

Voraussetzungen

Windows-, macOS- oder Linux-System
Administratorzugriff zum Installieren von Software
Ein Google-Konto mit Gemini-Zugriff
Grundlegende Kenntnisse mit Befehlszeilenschnittstellen
Blender auf Ihrem System installiert (optional, aber empfohlen)

Schritt 1: Node.js installieren

Gemini CLI und der Blender MCP-Server benötigen Node.js zum Ausführen. Führen Sie diese Schritte aus, um es zu installieren:

Für Windows:

Besuchen Sie nodejs.org
Laden Sie die LTS-Version (Long-Term Support) herunter
Führen Sie das Installationsprogramm aus und folgen Sie dem Installationsassistenten
Akzeptieren Sie alle Standardoptionen (dies umfasst npm und PATH-Konfiguration)
Klicken Sie auf "Fertig", um die Installation abzuschließen

Für macOS:

Mit Homebrew: brew install node
Oder laden Sie es von nodejs.org herunter und führen Sie das Installationsprogramm aus

Für Linux:

Verwenden Sie Ihren Paketmanager. Beispielsweise auf Ubuntu/Debian:

sudo apt update
sudo apt install nodejs npm

Node.js-Installation überprüfen

Öffnen Sie ein Terminal oder eine Eingabeaufforderung und führen Sie aus:

node --version
npm --version

Beide Befehle sollten Versionsnummern zurückgeben, wenn Node.js korrekt installiert ist.

Schritt 2: Gemini CLI herunterladen und installieren

Jetzt, da Node.js installiert ist, können Sie Gemini CLI herunterladen und einrichten:

Installationsschritte

Öffnen Sie ein Terminal oder eine Eingabeaufforderung
Navigieren Sie zu einem Verzeichnis oder erstellen Sie eines, in dem Sie Ihr Gemini CLI-Projekt speichern möchten (wir nennen es gmcp)
Erstellen Sie das Verzeichnis:
```
mkdir gmcp
cd gmcp
```

Laden Sie Gemini CLI mit npm herunter:

npm install -g @google/generative-ai-cli

Alternativ können Sie npx verwenden, um es direkt ohne globale Installation auszuführen:
```
npx @google/generative-ai-cli
```

Schritt 3: Blender MCP-Dienst konfigurieren

Die Konfiguration des MCP-Dienstes (Model Context Protocol) ist der wichtigste Schritt, um Blender MCP mit Gemini CLI zu verbinden.

Konfigurationsdatei suchen

Gemini CLI speichert seine Konfiguration in einer Einstellungsdatei unter:

D:\seocode\tmp\gmcp\.gemini\settings.json

Konfiguration hinzufügen

Öffnen Sie die Datei settings.json mit Ihrem bevorzugten Texteditor (z. B. Visual Studio Code, Notepad++ oder sogar Editor).

Fügen Sie die folgende Konfiguration hinzu oder aktualisieren Sie sie, um den Blender MCP-Dienst zu aktivieren:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Erklärung der Konfiguration

mcpServers: Ein Objekt, das alle MCP-Dienst-Definitionen enthält
blender: Der Name Ihres MCP-Dienstes (wird zur Identifizierung in Gemini CLI verwendet)
command: Der auszuführende Befehl (uvx ist ein Paketläufer für Python)
args: Argumente, die an den Befehl übergeben werden (blender-mcp ist das Blender MCP-Paket)

Konfiguration speichern

Speichern Sie die Datei nach dem Hinzufügen der Konfiguration. Stellen Sie sicher, dass die JSON korrekt formatiert ist, ohne nachfolgende Kommas oder Syntaxfehler.

Schritt 4: Gemini CLI beenden und erneut anmelden

Um die neue MCP-Dienst-Konfiguration anzuwenden, müssen Sie Gemini CLI neu starten:

Gemini CLI beenden

Wenn Gemini CLI ausgeführt wird, beenden Sie es durch Eingabe:

exit

Erneut anmelden

Starten Sie Gemini CLI in Ihrem Terminal neu:

npx @google/generative-ai-cli

Oder wenn Sie es global installiert haben:

gemini-cli

Schritt 5: MCP-Dienst-Konfiguration überprüfen

Nachdem Sie sich erneut bei Gemini CLI angemeldet haben, überprüfen Sie, ob der Blender MCP-Dienst ordnungsgemäß konfiguriert ist und verfügbar:

Dienststatus überprüfen

In Gemini CLI sollten Sie eine Ausgabe sehen, die anzeigt, dass der MCP-Dienst geladen wurde. Suchen Sie nach Meldungen wie:

[INFO] Loading MCP services...
[INFO] Blender MCP service loaded successfully
[INFO] Available tools: blender_create_object, blender_modify_object, ...

Integration testen

Versuchen Sie, einen einfachen Befehl auszugeben, der den Blender MCP-Dienst verwendet. Beispiel:

Create a cube in Blender

Wenn Blender mit dem installierten MCP-Plugin ausgeführt wird, sollten Sie einen Würfel in Ihrer Blender-Szene sehen. Gemini verarbeitet Ihre Anfrage und sendet Befehle über das MCP-Protokoll an Blender.

Fehlerbehebung

Problem: Settings.json nicht gefunden

Lösung: Erstellen Sie manuell den Ordner .gemini in Ihrem Projektverzeichnis und erstellen Sie eine Datei settings.json mit der oben angegebenen Konfiguration.

Problem: "uvx command not found"

Lösung: Installieren Sie das erforderliche Python-Paket:

pip install uv

Problem: MCP-Dienst wird nicht geladen

Lösung: Überprüfen Sie folgende Punkte:

Überprüfen Sie die JSON-Syntax in settings.json ist korrekt (verwenden Sie bei Bedarf einen JSON-Validator)
Stellen Sie sicher, dass der Dateipfad korrekt ist: D:\seocode\tmp\gmcp\.gemini\settings.json
Überprüfen Sie, dass Blender MCP installiert ist: uvx blender-mcp --version
Überprüfen Sie Gemini CLI-Protokolle auf detaillierte Fehlermeldungen

Problem: Blender antwortet nicht auf Befehle

Lösung: Stellen Sie sicher, dass:

Blender mit dem installierten MCP-Plugin ausgeführt wird
Das MCP-Plugin in den Blender-Einstellungen aktiviert ist
Sowohl Gemini CLI als auch Blender sind auf dem korrekten Netzwerkport verbunden

Nächste Schritte

Jetzt, da Sie Blender MCP mit Gemini CLI konfiguriert haben, können Sie:

Komplexe 3D-Szenen mit natürlichsprachigen Eingabeaufforderungen erstellen
Objekte und Materialien mit KI-Unterstützung ändern
Wiederholte 3D-Modellierungsaufgaben automatisieren
Geminis KI-Funktionen mit Blenders leistungsstarken 3D-Tools kombinieren
Erkunden Sie erweiterte MCP-Funktionen für benutzerdefiniertes Scripting und Automatisierung

Weitere Informationen zur Verwendung von Blender MCP finden Sie im offiziellen GitHub-Repository.

Fazit

Das Einrichten von Blender MCP mit Gemini CLI eröffnet eine Welt von Möglichkeiten für KI-gestützte 3D-Modellierung. Obwohl der Konfigurationsprozess mehrere Schritte umfasst, sollten Sie mit dieser Anleitung schnell zum Laufen kommen. Denken Sie daran, dass der Schlüssel zum Erfolg darin besteht, Ihre Konfigurationsdateien korrekt zu formatieren und alle Komponenten ordnungsgemäß zu installieren.

Wenn Sie Probleme haben oder Fragen haben, lesen Sie den Abschnitt "Fehlerbehebung" oder konsultieren Sie die Blender MCP-Dokumentation.