Blender MCP server

Wenn du nach "Blender MCP" suchst, bekommst du Installationsanleitungen für ein Projekt, das seinen Namen geändert hat, eine Verzeichnisseite für jeden Fork und fast nichts zu der Tatsache, dass Blender inzwischen seinen eigenen Server hat. Zwei Projekte sind relevant, sie erledigen unterschiedliche Aufgaben, und beide nutzen standardmäßig denselben Port – es lohnt sich also zu wissen, welches du installierst.

Wir haben am 14. November 2026 den Quellcode und die Docs beider Projekte gelesen, MCP for Blender 2.2.9 über MCP Inspector auf einem Mac mit installiertem Blender 5.2.3 ausgeführt und die Zahlen an diesem Tag gegen GitHub, PyPI und projects.blender.org geprüft.

Die beiden Server

	MCP for Blender	Blender Lab MCP server
Wer	ahujasid und Contributors, Community	Blender Lab, Teil des Blender-Projekts
Repository	ahujasid/mcp-for-blender (früher blender-mcp)	projects.blender.org/lab/blender_mcp
Lizenz	MIT	GPL-3.0-or-later
Stars	34.351 auf GitHub	37 auf projects.blender.org
Neueste Version	2.2.9 auf PyPI, 13. November 2026	v1.0.3, 11. September 2026
Blender	3.0 oder neuer	5.1 oder neuer
Tools	10	26
Stärke	Szenen bauen: Code ausführen, Ergebnis ansehen, Assets holen, Modelle generieren	Szenen lesen: Zusammenfassungen, Docs-Suche, Screenshots, zu Objekten springen
In Claude	Jeder Client über uvx	Der Blender-Connector in Claude Desktop

Beide funktionieren unter der Haube gleich. Blender hat keine Netzwerk-API, deshalb bringt jedes Projekt zwei Teile mit: ein Add-on, das in Blender einen TCP-Socket öffnet, und einen MCP server, den dein Client startet. Der Client spricht MCP mit dem Server, der Server schickt Befehle über den Socket, und das Add-on führt sie im Main-Thread von Blender aus. Deshalb muss das Add-on aktiviert und am Laufen sein, bevor irgendein Tool funktioniert.

Welchen du nimmst, hängt davon ab, was das Modell für dich tun soll. Wenn es eine Szene modellieren, beleuchten und ausstatten soll, ist MCP for Blender genau für diesen Loop gebaut: Python schreiben, Viewport ansehen, korrigieren, wiederholen. Wenn du Hilfe dabei willst, eine Datei zu verstehen, die dir jemand geschickt hat, fehlende Texturen zu finden oder die Frage zu beantworten, wie du etwas in der Python-API machst, ist der Server von Blender Lab bewusst enger gefasst und bringt Blenders eigenes Handbuch und die API-Docs mit.

MCP for Blender, der Community-Server

Das ist das, was die meisten Tutorials "Blender MCP" nennen. Er wurde erstmals im März 2025 veröffentlicht, hat 34.000 Stars überschritten und wurde im September 2026 von blender-mcp in MCP for Blender umbenannt. In der Notiz des Maintainers zur Umbenennung heißt es, dass nichts kaputtgeht: uvx blender-mcp funktioniert weiterhin über ein Kompatibilitätspaket, der Import-Pfad bleibt unverändert, und das Add-on ist dieselbe Datei. Ein Teil der Begründung war, Verwechslungen mit dem offiziellen Blender Lab-Projekt zu vermeiden. Das README stellt außerdem klar, dass das Projekt nicht mit der Blender Foundation verbunden ist.

Was die zehn Tools machen

Wir haben die Tools mit der CLI von MCP Inspector gegen Version 2.2.9 aufgelistet und zehn bekommen, eines mehr als die Zeile "nine tools" im README:

Tool	Was es macht
execute_blender_code	Führt Python in der laufenden Blender-Session aus
look	Zeigt den Viewport, eine Kamera, ein Multi-Angle-Sheet oder Animationsframes, in solid, material, rendered, wireframe oder x-ray
get_scene_info	Eine Textzusammenfassung von Objekten, Größen, Materialien und Mesh-Zustand
search_assets	Durchsucht Poly Haven, Sketchfab und Poly Pizza
import_asset	Holt ein gefundenes Asset in die Szene
generate_3d	Erzeugt ein Modell aus Text oder einem Bild mit Hyper3D Rodin, Hunyuan3D, Meshy oder Tripo
generate_gaussian_world	Eine World Labs Gaussian-Splat-Szene, Blender 5.3 oder neuer
get_addon_status	Blender- und Add-on-Versionen, welche Bibliotheken und Generatoren aktiv sind
disable_telemetry	Schaltet die Datenerfassung ab
record_trajectory_feedback	Schickt Feedback zu einer Session, nur wenn du zugestimmt hast

Das Paar, das ihn nützlich macht, ist execute_blender_code und look. Ein Modell, das nur Code schreiben kann, rät; eines, das den Viewport rendern und sehen kann, dass der Stuhl 30 cm über dem Boden schwebt, kann das korrigieren. Poly Haven braucht keinen Key und seine Assets sind CC0. Poly Pizza braucht einen kostenlosen Key, und etwa zwei Drittel der Modelle sind CC-BY, also schuldest du den Autoren eine Nennung. Die Generatoren brauchen deine eigenen API-Keys oder den kostenpflichtigen Premium-Plan, auf den das README verlinkt.

Installation

Du brauchst Blender 3.0 oder neuer, Python 3.10 oder neuer und uv. Installiere uv mit dem offiziellen Installer oder brew install uv; laut README sollst du pip install uv nicht verwenden.

Das Projekt bietet einen Einzeiler-Installer, der ein Skript von seiner Website in deine Shell pipet. Er funktioniert, aber lies ihn dir vorher durch, wenn du sowas überhaupt machst. Der manuelle Weg sind zwei Befehle und eine Checkbox. Zuerst das Add-on:

uvx mcp-for-blender install-addon

Das kopiert blender_mcp.py in Blenders Add-ons-Ordner und gibt den Pfad aus. Dann öffnest du Blender, gehst auf Edit, Preferences, Add-ons und aktivierst "Interface: MCP for Blender". Drück N in der 3D-Ansicht und öffne den Tab MCP for Blender. Der Server sollte laufen; wenn das Panel einen Button zum Starten anbietet, klick ihn. Das README nennt diesen Button in zwei Abschnitten zwei verschiedene Namen, also such nach dem, den deine Version anzeigt.

Dann fügst du den Server zu deinem Client hinzu.

Claude Code

claude mcp add blender uvx mcp-for-blender

Codex

codex mcp add blender -- uvx mcp-for-blender

Claude Desktop und Cursor nutzen dasselbe JSON. In Claude Desktop gehört es in claude_desktop_config.json (Settings, Developer, Edit Config); in Cursor in Settings, MCP oder .cursor/mcp.json:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"],
      "env": { "DISABLE_TELEMETRY": "true" }
    }
  }
}

Unter Windows braucht Cursor "command": "cmd" mit "args": ["/c", "uvx", "mcp-for-blender"]. Die env-Zeile ist optional; sie steht wegen des Telemetrie-Standardwerts da, der unten beschrieben ist. Wenn du denselben Eintrag für mehrere Clients gleichzeitig willst, schreibt ihn unser Config-Builder für jeden einzelnen.

Führe uvx mcp-for-blender nicht zusätzlich selbst in einem Terminal aus. Der Client startet den Server. Eine zweite Kopie konkurriert um dasselbe Blender, und die Antwort des Maintainers in Issue 52 war schlicht, dass es nicht funktioniert, wenn es an mehr als einer Stelle läuft.

Was wir gesehen haben, als Blender geschlossen war

Wir haben den Server über MCP Inspector gestartet, während Blender nicht lief. Der Server kam hoch, prüfte das Add-on auf der Festplatte ("Blender addon on disk is current (protocol 16)") und loggte dann Failed to connect to Blender: [Errno 61] Connection refused. Das Auflisten der Tools funktionierte trotzdem, weil die Liste Blender nicht braucht.

Der Aufruf von get_scene_info gab den Text "Could not connect to Blender. Make sure the Blender addon is running." zurück, mit isError auf false. Dieses Detail ist wichtig, wenn du Checks scriptest: Die Inspector-CLI beendete sich mit 0, ein CI-Schritt würde den Fehler also als Erfolg lesen. Prüf den Text des Ergebnisses, nicht nur den Exit-Code.

Der offizielle Server von Blender Lab

Blender Lab ist ein Bereich innerhalb des Blender-Projekts, um Neues auszuprobieren, eingerichtet im Februar 2026. Sein MCP server liegt unter projects.blender.org/lab/blender_mcp, und blender.org hat dafür eine Seite. Als Anthropic am 28. April 2026 seine Connectors für kreative Arbeit ankündigte, hieß es, die Blender-Entwickler hätten einen MCP connector gebaut, der jetzt offiziell für Claude verfügbar ist. Blender hat sich dafür entschieden, Anthropics Beitrag als einmalige Spende anzunehmen statt über den Development Fund.

Seine 26 Tools lesen mehr, als sie schreiben. Es gibt Zusammenfassungen der Datablocks einer .blend-Datei, fehlender Dateien, verlinkter Libraries und Pfade; Objekt-Zusammenfassungen; Screenshots eines Fensters oder Bereichs; Tools, um die Oberfläche zu einem Tab oder Objekt zu springen; Thumbnail- und Viewport-Renders in eine Datei; und eine Suche über Blenders Python-API-Docs und Handbuch, die mit dem Server ausgeliefert werden. Mehrere Datei-Tools haben einen _for_cli-Zwilling, der in einem separaten Blender im Hintergrund läuft, sodass das Modell eine Datei inspizieren kann, die du nicht geöffnet hast. Außerdem gibt es execute_blender_code, damit kann es auch Dinge ändern.

Installieren

Das Add-on braucht Blender 5.1 oder neuer. Das sagen blender.org und das Manifest des Add-ons; das Claude-Academy-Tutorial von Anthropic nennt 4.2, was veraltet wirkt. Installiere das Add-on, indem du den Link von der blender.org-Seite zweimal in Blender ziehst: Der erste Drop fügt das Extension-Repository "lab" hinzu, der zweite installiert. Dann gehst du auf Edit, Preferences, Add-ons, öffnest den Tab und startest den MCP server. Dort kannst du auch Auto-Start aktivieren.

In Claude Desktop konfigurierst du nichts von Hand: Öffne Customize, Connectors, suche nach Blender und füge es hinzu. Das geht nur in Claude Desktop, nicht in claude.ai im Browser, weil Blender auf derselben Maschine laufen muss. Laut der Academy-Seite funktioniert der kostenlose Plan.

Für andere Clients gibt es auf der Release-Seite ein .mcpb-Bundle, oder du klonst das Repository und verweist deinen Client mit uv darauf:

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["--directory", "/Users/you/blender_mcp/mcp", "run", "blender-mcp"]
    }
  }
}

Das Add-on lauscht außerdem auf localhost Port 9876. Wenn du beide Add-ons aktiviert hast, starte immer nur eines gleichzeitig, oder verschiebe eines in seinen Preferences auf einen anderen Port.

Sicherheit: was beide Projekte sagen

Beide Server geben dem Modell einen Python-Interpreter in Blender. Python in Blender kann Dateien lesen und löschen, Netzwerkverbindungen öffnen und Programme starten – mit denselben Rechten wie dein Benutzerkonto. Keines der beiden Projekte verschweigt das.

Die README von MCP for Blender sagt, execute_blender_code "can be powerful but potentially dangerous", und rät dir fett gedruckt, immer zuerst deine Arbeit zu speichern. Außerdem steht dort, dass der Socket des Add-ons weder Authentifizierung noch Verschlüsselung hat, sodass jeder, der den Port erreicht, Python in deinem Blender ausführen kann. Die Seite von Blender Lab geht weiter: Generierter Code läuft "without any guards in place", und sie empfiehlt eine virtuelle Maschine oder ein System ohne sensible Daten.

Was wir tatsächlich machen würden:

• Speichern und Versionen behalten. Änderungen passieren in der laufenden Sitzung. Nichts wird auf die Festplatte geschrieben, bis du speicherst – was auch heißt, dass ein schlechtes Skript eine ungespeicherte Stunde Arbeit zerstören kann. Die Einstellung Save Versions unter Preferences, Save & Load ist eine günstige Versicherung.
• Safe Mode in MCP for Blender einschalten. Setze BLENDER_MCP_SAFE_MODE=1 in der env des Servers. Skripte werden vor der Ausführung geprüft, und Dateizugriff, andere Programme, Netzwerkzugriff und Persistenz sind blockiert. Standardmäßig ist es aus, und manche Asset-Workflows brauchen es aus.
• Den Socket auf localhost lassen. Das Add-on hat die Einstellungen "Bind Address" und "Allow Remote Connections". Lass sie in Ruhe; für ein entferntes Blender nimmst du einen SSH-Tunnel.
• Nach dem Code fragen. Bei allem, was viele Objekte löscht oder umbenennt, bitte das Modell, das Skript zu zeigen, bevor es läuft. Das Tutorial von Anthropic empfiehlt dasselbe.
• Die Telemetrie-Voreinstellung prüfen. MCP for Blender sendet standardmäßig pro Tool-Aufruf einen minimalen anonymen Datensatz: zufällige Installations- und Session-IDs, Tool-Name, Erfolg, Dauer, Versionen, OS und Zeit. Prompts, Code, Screenshots und Szenendaten werden nur gesendet, wenn du das Consent-Kästchen ankreuzt, und laut README können opt-in-Daten zum Trainieren von KI-Modellen verwendet werden. DISABLE_TELEMETRY=true schaltet alles ab.

Für das größere Bild dazu, was ein lokaler MCP server erreichen kann, siehe MCP security.

Wenn keine Verbindung zustande kommt

Fast jedes Blender-MCP-Problem ist eine von vier Bruchstellen in der Kette vom Client zu Blender. Geh sie der Reihe nach durch.

Was du siehst	Ursache	Fix
spawn uvx ENOENT im Client-Log	Apps, die aus dem Dock oder Startmenü gestartet werden, bekommen nicht den PATH deines Terminals	Nimm den vollständigen Pfad aus which uvx (zum Beispiel /opt/homebrew/bin/uvx) als Befehl, oder cmd /c uvx unter Windows, beende dann den Client vollständig und öffne ihn neu
"Could not connect to Blender", im Log steht Connection refused	Blender geschlossen, Add-on deaktiviert oder sein Server nicht gestartet	Öffne Blender, aktiviere das Add-on, starte den Server im N-Panel
Tools schlagen zufällig fehl oder die Verbindung bricht ab	Mehr als eine Kopie des Servers; ein User hat in Issue 52 vier gefunden, obwohl er nur Claude Desktop gestartet hatte	Halte ihn in einem Client oder schließe die anderen; prüfe auf verwaiste mcp-for-blender-Prozesse
Server stürzt beim Start mit einem Python-Fehler ab	conda- oder pyenv-Python wurde aufgegriffen, oder ein neues CPython ohne Wheels	Füge "--python", "3.11" vor dem Paketnamen in args hinzu und "UV_PYTHON_PREFERENCE": "only-managed" in env
Altes Verhalten nach einem Update	uv-Cache	uv cache clean mcp-for-blender blender-mcp, dann uvx --refresh mcp-for-blender
Server in Docker oder einem Dev-Container erreicht Blender nicht	localhost im Container ist der Container	Setze BLENDER_HOST=host.docker.internal unter macOS und Windows; unter Linux nutze --network=host
Blender friert beim Importieren ein	Poly-Haven-Downloads laufen im Main-Thread von Blender	Warte; es geht weiter, wenn der Download fertig ist
Zwei Blender-Fenster, eines wird ignoriert	Beide Add-ons auf 9876	Gib dem zweiten Add-on einen anderen Port und starte einen zweiten Server mit --port

Das README gibt außerdem zu, dass der erste Befehl nach dem Verbinden manchmal fehlschlägt und der zweite funktioniert. Wenn er weiterhin fehlschlägt, starte sowohl den Client als auch den Server in Blender neu, bevor du irgendetwas anderes änderst.

Weitere Blender MCP server

Es gibt reichlich Forks. Auf GitHub am 14. November 2026 waren die mit einer echten Historie nach MCP for Blender dhakalnirajan/blender-open-mcp (123 Stars, MIT), gebaut für lokale Modelle über Ollama, LM Studio oder llama.cpp und mit demselben Add-on-Port; pranav-deshmukh/blender-mcp (99 Stars, MIT, zuletzt gepusht im August 2025); und bpy-dev/blender-mcp (97 Stars, GPL-3.0), ein Repackaging des Servers von Blender Lab.

Wir haben eine Gruppe von Repositories mit fast identischen Namen und je etwa 200 Stars weggelassen, alle am 12. November 2026 gepusht, eines davon am selben Tag erstellt. Star-Zahlen, die innerhalb von zwei Tagen auftauchen, wirken gekauft, und ein Add-on führt Code innerhalb von Blender aus. Wenn ein Blender MCP project neu ist, prüf seine Commit-Historie und wer dazu beiträgt, bevor du es installierst.

Die vollständige Liste der Server, die Blender erwähnen, mit Checks-Scores und Installationsbefehlen steht in der Tabelle oben auf dieser Seite.

Was du installierst

• Du willst, dass ein Agent Szenen baut oder ändert, in egal welchem Client: MCP for Blender. Schalte den Safe Mode erst aus, wenn du weißt, welche Workflows ihn brauchen.
• Du nutzt Claude Desktop und willst vor allem Antworten zu deiner Datei oder der API: der offizielle Blender-Connector. Zwei Klicks, und die Docs-Suche hält die Antworten an Blenders echter API.
• Du betreibst ein lokales Modell: blender-open-mcp oder MCP for Blender in einem Client, der dein lokales Backend unterstützt.
• Du bist auf Blender älter als 5.1: MCP for Blender ist von den beiden das einzige, das lädt.

Egal wofür du dich entscheidest, der erste nützliche Prompt ist derselbe: Bitte das Modell, die Szene zu beschreiben, bevor es irgendetwas ändert. Wenn es das kann, funktioniert die ganze Kette.