blender-mcp: Blender über einen Socket-Server an einen LLM-Client anbinden

Welches Problem der Socket zwischen Chat und Viewport löst

Ein LLM kann Blender nicht sehen und nicht anfassen. blender-mcp schließt diese Lücke nicht über eine Dateiübergabe und nicht über ein Skript, das man von Hand startet, sondern über eine dauerhafte Verbindung: Das Addon öffnet in der laufenden Blender-Sitzung einen Socket-Server, der Serverprozess auf der anderen Seite spricht Model Context Protocol mit dem Chat-Client. Damit wird aus einer Prompt-Eingabe eine Objektoperation im gerade geöffneten Projekt. Die Zielgruppe sind laut README Einzelpersonen, die modellieren, Szenen aufbauen oder vorhandene Szenen umbauen wollen, ohne für jede Änderung die Python-API von Blender zu lernen. Der Titel der Seite ist insofern ehrlich: Es geht um prompt-gestütztes Arbeiten, nicht um generative Geometrie aus dem Nichts, auch wenn Asset- und Modellgenerierung als Feature aufgeführt wird.

Zwei Prozesse, ein Socket und der Weg eines Befehls

Die Architektur besteht aus genau zwei Teilen, und das README benennt beide mit Pfad: das Addon addon.py, das den Socket-Server innerhalb von Blender aufspannt, und den MCP-Server src/blender_mcp/server.py, der das Protokoll implementiert und sich mit dem Addon verbindet. Der Datenfluss ist damit gerichtet und einfach zu prüfen: Der Client schickt einen MCP-Aufruf an den Serverprozess, dieser reicht ihn über den Socket an Blender weiter, das Addon führt ihn aus und liefert ein Ergebnis zurück. Bemerkenswert ist, dass das README als Fähigkeit ausdrücklich die Ausführung von beliebigem Python-Code in Blender nennt. Das ist der eigentliche Mechanismus hinter den meisten Operationen: Objekte anlegen, Materialien setzen, Szenen inspizieren, all das läuft letztlich als Python im Blender-Kontext. Wer diesen Satz im README überliest, versteht die Sicherheitsdiskussion des Projekts nicht, denn die Reichweite der Steuerung ist genau die Reichweite der Blender-Python-API.

Installation in vier Schritten mit uvx

Der Weg ist im README als vierteilige Schnellstartanleitung beschrieben. Zuerst uv installieren, ausdrücklich nicht über pip: Für macOS nennt das README brew install uv, für Linux curl -LsSf https://astral.sh/uv/install.sh | sh, für Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex". Danach trägt man den Server beim Client ein. Für Claude Desktop ist das ein JSON-Block mit dem Schlüssel mcpServers und dem Eintrag blender, dessen command uvx lautet und dessen args aus dem einzelnen Wert blender-mcp bestehen. Für Claude Code genügt claude mcp add blender uvx blender-mcp, für Codex lautet das Gegenstück codex mcp add blender -- uvx blender-mcp. Drittens das Addon: uvx blender-mcp install-addon, anschließend in Blender unter Edit, Preferences, Add-ons der Eintrag Interface: MCP for Blender aktivieren. Viertens verbinden: im 3D-Viewport N drücken, den Tab MCP for Blender öffnen und Start MCP Server klicken. Das README warnt an dieser Stelle, nur eine Instanz des Servers laufen zu lassen, also entweder Cursor oder Claude Desktop, nicht beide.

Warum uvx im GUI-Client oft nicht gefunden wird

Der häufigste Fehler beim Einstieg ist kein Fehler des Projekts, sondern einer der Prozessumgebung. MCP-Clients, die aus einer grafischen Oberfläche gestartet werden, erben den PATH des Terminals nicht. Ein blankes command mit dem Wert uvx kann deshalb mit spawn uvx ENOENT scheitern, obwohl uvx in der Shell funktioniert. Das README nennt als Ausweg, den vollen Pfad zu ermitteln, unter macOS und Linux mit which uvx, unter Windows mit where uvx, und diesen Pfad dann als command einzutragen, beispielsweise /opt/homebrew/bin/uvx. Auf Windows kommt ein zweiter Schritt hinzu: uv liegt in %USERPROFILE%\.local\bin, dieser Ordner muss in die Benutzer-PATH-Variable aufgenommen werden, und das README merkt an, dass ein Neustart von Claude Desktop nötig sein kann. Wer diese beiden Punkte kennt, spart sich die Fehlersuche an der falschen Stelle, nämlich im Blender-Addon.

Codeausführung als Fähigkeit und als Risiko

Das README führt einen eigenen Abschnitt Limitations & Security Considerations, was für ein Projekt dieser Art die richtige Entscheidung ist. Der Grund liegt auf der Hand: Wenn ein Werkzeug beliebigen Python-Code in einer laufenden Blender-Instanz ausführen kann, dann ist jede Prompt-Eingabe ein potenzieller Programmpfad, und die Grenze zwischen Modellieren und Systemzugriff ist nur so scharf wie die Sorgfalt des Anwenders. Das Projekt macht daraus keine Beschönigung, sondern dokumentiert die Einschränkungen an einer eigenen Stelle. Für die Praxis heißt das: Man sollte blender-mcp nicht in einer Blender-Sitzung laufen lassen, in der ungespeicherte Arbeit liegt, die man nicht reproduzieren kann, und man sollte keine Prompts oder Textbausteine aus fremden Quellen ungeprüft durchreichen. Wer eine Umgebung mit mehreren Nutzern oder mit fremden Assets betreibt, findet in diesem Abschnitt die Grenzen beschrieben, nicht in einem Marketingtext.

Telemetrie, API-Schlüssel und was das Addon mitschickt

Zwei weitere Punkte stehen im Inhaltsverzeichnis und betreffen den Betrieb, nicht die Funktion: Persistent API Credentials und Telemetry Control. Beide Abschnitte existieren, weil blender-mcp nicht nur lokal rechnet. Für die Asset- und Modellgenerierung nennt das README externe Quellen: Poly Haven, Sketchfab, Poly Pizza sowie die Dienste Hyper3D Rodin und Hunyuan3D. Wer diese Fähigkeiten nutzt, gibt Daten an Dritte und braucht Zugangsdaten, die irgendwo hinterlegt werden. Genau deshalb sind die beiden Abschnitte im README relevant, und genau deshalb sollte man sie vor dem ersten Einsatz lesen und nicht danach. Für reine Objektmanipulation und Szeneninspektion bleiben diese Abhängigkeiten außen vor, aber die Installation bringt sie mit.

Wann man besser bei Blenders eigener Python-Konsole bleibt

Die naheliegende Alternative ist kein anderes MCP-Projekt, sondern der direkte Weg: die Python-Konsole in Blender oder ein eigenes Addon. Der Unterschied liegt nicht in der Fähigkeit, sondern in der Wiederholbarkeit. Ein Skript in der Konsole ist ein Artefakt, das man versionieren, lesen und erneut ausführen kann. Eine Chat-Sitzung mit blender-mcp erzeugt Zwischenstände, deren Herkunft man rekonstruieren muss. Für einmalige Umbauten, für Erkundung und für Aufgaben, bei denen man den Weg nicht vorher kennt, ist der Chat bequemer. Für Pipelines, für wiederkehrende Exporte und für alles, was in einer Versionsverwaltung landen soll, ist ein Skript die bessere Wahl, weil es denselben Effekt ohne Modell und ohne Netzverbindung erzielt. Das Projekt ersetzt die Blender-API nicht, es setzt eine natürlichsprachliche Schicht davor, und diese Schicht ist nicht deterministisch.

Wartung, Lizenz und wer das betreiben sollte

Das Projekt steht unter MIT, der Quelltext darf also verwendet, verändert und weitergegeben werden, sofern der Lizenztext erhalten bleibt. Das README weist außerdem darauf hin, dass es sich um eine Integration von Dritter Seite handelt und nicht von Blender selbst stammt. Für die Wartung bedeutet das: Die Kompatibilität mit Blender-Versionen hängt an den Pflegen des Projekts, das README nennt Blender 3.0 oder neuer und Python 3.10 oder neuer als Voraussetzungen. Ein Upgrade ist im README als eigener Abschnitt für bestehende Nutzer vorgesehen, was darauf hindeutet, dass Addon und Server zusammen aktualisiert werden müssen und nicht unabhängig voneinander. Wer das Addon in einer festen Umgebung einsetzt, sollte beide Teile gemeinsam behandeln, sonst passt die Protokollversion nicht mehr zusammen. Das ist der wiederkehrende Aufwand, und er ist gering, aber er verschwindet nicht.

Redaktionelles Fazit

Sinnvoll ist blender-mcp für einzelne Anwender an einem Arbeitsplatz, die eine offene Blender-Sitzung per Chat steuern und dabei unsauberen oder fehlerhaften Code in Kauf nehmen wollen. Ungeeignet ist es für unbeaufsichtigte Läufe und für alles, wo fremde Prompts oder fremde Assets in dieselbe Blender-Instanz gelangen. Vor dem ersten produktiven Einsatz sollte man den Abschnitt Limitations & Security Considerations vollständig lesen, weil dort die Codeausführung und die Rechte des Addons beschrieben sind, und danach in Blender unter Edit, Preferences, Add-ons prüfen, ob Interface: MCP for Blender aktiv ist und der Server nur einmal läuft.

Offizielle Quellen

1. ahujasid/blender-mcp on GitHub
2. Issues
3. License: MIT
4. Project website
5. README