Was Blender MCP ist
MCP (Model Context Protocol) gibt einem Agenten Tools, die auf ein anderes Programm wirken. Beide Blender-MCP-Projekte bestehen aus denselben zwei Teilen: einem Add-on, das einen kleinen Server in Blender betreibt, und einem MCP-Server, den dein Agent startet und der seine Tool-Aufrufe als JSON über einen TCP-Socket an das Add-on weiterreicht.
Das Projekt, das die meisten meinen, ist mcp-for-blender. Sein README beginnt mit dem Hinweis, dass es eine Drittanbieter-Integration ist und nicht von Blender stammt. Es steht unter der MIT-Lizenz, hatte am 21. November 2026 35.153 GitHub-Sterne, und sein PyPI-Paket wurde von blender-mcp in mcp-for-blender umbenannt (Version 2.3.1 am 18. November); uvx blender-mcp startet den Server weiterhin, ältere Konfigurationen funktionieren also weiter.
Das blender_mcp von Blender Lab ist das offizielle. Sein Readme nennt es einen schlanken Server, bewusst klein, gedacht für eine Schnittstelle in natürlicher Sprache zu Blenders Python-API, besseren Zugriff auf die Dokumentation und das Erkunden komplexer Szenen. Er ist im Connector-Verzeichnis von Claude als Blender, erstellt von Blender Lab, von Anthropic verifiziert, aufgeführt.
mcp-for-blender gegen Blender Labs blender_mcp
Angaben aus den Repositories auf GitHub und projects.blender.org vom 21. November 2026.
| mcp-for-blender (Community) | blender_mcp (Blender Lab) | |
|---|---|---|
| Entwickelt von | Siddharth Ahuja; ohne Verbindung zur Blender Foundation | Blender Lab, Teil des Blender-Projekts |
| Lizenz | MIT | GPL-3.0 |
| Blender-Version | 3.0 oder neuer | 5.1 oder neuer |
| Sterne | 35.153 auf GitHub | 39 auf projects.blender.org |
| Tools | Neun, darunter execute_blender_code, look (Viewport- und Kameraansichten), get_scene_info, Asset-Suche und -Import (Poly Haven, Sketchfab, Poly Pizza) und generate_3d (Tripo, Hunyuan3D, Hyper3D Rodin, Meshy) | execute_blender_code, execute_blender_code_for_cli (Blender im Hintergrund), Zusammenfassungen von Blend-Dateien und Objekten, get_python_api_docs, Screenshots; bringt Auszüge aus Python-API und Handbuch mit |
| Installation | Ein-Befehl-Installer oder uvx mcp-for-blender; eingebaute Einrichtung für Claude Code, Codex, Cursor und weitere | Repo per git clone holen und mit uv starten; Add-on in Blender hinzufügen |
| Am besten für | Szenen aufbauen und ausstatten, Assets einbinden, Modelle generieren | Dateien untersuchen und Fragen zu Blenders API stellen, auf aktuellem Blender |
Schnellinstallation: alle deine Agenten auf einmal
Der empfohlene Weg im README von mcp-for-blender ist ein einziger Befehl. Er installiert bei Bedarf uv, findet die MCP-Clients auf deinem Rechner (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), lässt dich auswählen, welche eingerichtet werden sollen, und installiert und aktiviert dann das Blender-Add-on. Er fügt jeder Konfiguration nur einen blender-Eintrag hinzu und legt von jeder geänderten Datei eine .bak an. Beende danach deinen Agenten vollständig und starte ihn neu.
Die folgenden Befehle sind aus dem README kopiert; wir haben sie nicht ausgeführt. Ein Skript in die Shell zu pipen führt es mit deinen Rechten aus. Wenn du jeden Schritt sehen möchtest, nimm stattdessen die manuelle Einrichtung in den nächsten zwei Abschnitten.
- macOS / Linux:
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh - Windows (PowerShell):
irm https://www.mcp-for-blender.com/install.ps1 | iex - Mit bereits installiertem uv:
uvx mcp-for-blender setup - Du brauchst Blender 3.0 oder neuer, Python 3.10 oder neuer und uv.
Blender MCP in Claude Code installieren
Manuelle Einrichtung von mcp-for-blender. Die Befehle sind aus dem Projekt-README und der Claude-Code-MCP-Dokumentation kopiert; wir haben sie nicht ausgeführt.
uv installieren
uv liefert den Befehl
uvx, der den Server startet. Das README rät vonpip install uvab; nimm den offiziellen Installer.# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -eServer registrieren
Das speichert den Server für das aktuelle Projekt. Mit
--scope usergilt er überall; Optionen dieser Art stehen vor einem--, das sie vom Server-Befehl trennt. So macht es auch die Claude-Code-Dokumentation. In einer Session zeigt/mcpdenselben Status an.# der Befehl aus dem README claude mcp add blender uvx mcp-for-blender # prüfen: der Server sollte als verbunden angezeigt werden claude mcp list claude mcp get blenderOptional: Telemetrie ausschalten
Laut README setzt du
DISABLE_TELEMETRY=truein der Umgebung des Servers, um die Telemetrie komplett abzuschalten.claude mcp addvon Claude Code nimmt Umgebungsvariablen mit--enventgegen; die genaue Form steht in der Claude-Code-MCP-Dokumentation.Blender-Add-on installieren und aktivieren
Öffne dann in Blender Edit → Preferences → Add-ons und aktiviere „Interface: MCP for Blender“. Drücke N im 3D-Viewport und öffne den Tab MCP for Blender; der Server startet mit Blender, und falls er nicht läuft, klicke auf Start MCP Server.
# kopiert das Add-on als blender_mcp.py in Blenders Add-on-Ordner (legt eine .bak an) uvx mcp-for-blender install-addon # listet die gefundenen Add-on-Ordner auf uvx mcp-for-blender addon-paths
Blender MCP in Codex installieren
Codex CLI, Desktop-App und IDE-Erweiterung teilen sich ~/.codex/config.toml, eine Einrichtung deckt also alle drei ab. Die Befehle sind aus dem README und der Codex-MCP-Dokumentation von OpenAI kopiert; wir haben sie nicht ausgeführt. Installiere uv und das Blender-Add-on wie in den Claude-Code-Schritten.
Server mit der CLI hinzufügen
Codex zeigt die Tools beim nächsten Start an;
/mcpin der Codex-Terminaloberfläche listet die aktiven Server auf. In der Desktop-App ist es Settings → MCP servers → Add server, Nameblender, STDIO, Befehluvx mcp-for-blender.# der Befehl aus dem README codex mcp add blender -- uvx mcp-for-blender # prüfen: blender sollte als aktiviert angezeigt werden codex mcp listOder config.toml bearbeiten
Die Tabelle
[mcp_servers.blender]stammt aus dem README. Die Zeileenvfolgt der Codex-Dokumentation, dieenv,startup_timeout_sec(Standard 10) undtool_timeout_sec(Standard 60) als Tabellenschlüssel aufführt; erhöhetool_timeout_sec, wenn lange Blender-Vorgänge in ein Timeout laufen.# oder von Hand in ~/.codex/config.toml (gemeinsam genutzt von Codex CLI, Desktop-App und IDE-Erweiterung) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]Optional: das Codex-Plugin
Das README empfiehlt es für Codex: Es zeigt einen Live-Blender-Viewport im Chat, Vorschaubild-Auswahl für Assets und @-Erwähnungen für Szenenobjekte. Es ist noch nicht im Codex-Plugin-Verzeichnis, du fügst es also aus dem Repo hinzu.
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # danach Codex neu starten und „MCP for Blender“ aus dem Plugin-Verzeichnis installieren
Stattdessen den offiziellen Server von Blender Lab installieren
Das Setup-Wiki von Blender Lab lässt dich sein Add-on in Blender 5.1 oder neuer installieren, den Server in deinen Home-Ordner klonen und deinen MCP-Client per uv darauf zeigen. Das sind der Clone-Befehl und die Konfiguration aus dem Wiki, wie festgehalten; wir haben sie nicht ausgeführt. Wenn du Claude nutzt, ist der Server auch im Connector-Verzeichnis von Claude aufgeführt, das vermerkt, dass das Add-on erforderlich ist.
git clone https://projects.blender.org/lab/blender_mcp.git, dann {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}
Registriere nicht beide Projekte unter demselben Namen blender. Das README von mcp-for-blender sagt außerdem, dass immer nur eine Instanz seines Servers laufen soll, zum Beispiel in Cursor oder Claude Desktop, aber nicht in beiden.
Beispiel: Ein Agent baut ein Low-Poly-Requisit und exportiert ein GLB
Bei geöffnetem Blender und laufendem Add-on modelliert der Agent über execute_blender_code und prüft seine Arbeit mit look. Wir haben das nach der Dokumentation geschrieben und nicht durchgängig ausgeführt, die Ergebnisse können also abweichen. Wie du das GLB mit glTF-Transform komprimierst und in three.js lädst, steht im vollständigen Blender-MCP-Leitfaden auf vibegamer.io.
Deine .blend-Datei speichern
Der Agent bearbeitet deine geöffnete Datei direkt. Die Warnung im README lautet: Speichere deine Arbeit immer, bevor du
execute_blender_codebenutzt.Den Agenten anweisen
Gib Maße, ein Dreiecksbudget und den Exportpfad an. Einfache Grundfarben werden sauber exportiert, weil Blenders glTF-Exporter die Grundfarbe aus dem Principled-BSDF-Knoten liest. Das README merkt außerdem an, dass komplexe Vorgänge eventuell in kleinere Schritte zerlegt werden müssen.
Nutze die Blender-MCP-Tools. Baue eine Low-Poly-Holzkiste für ein Browserspiel: - 1-m-Würfel, steht auf dem Boden bei z = 0, Ursprung in der Mitte der Unterseite. - Abgeschrägte Bretter und Eckverstärkungen, unter 800 Dreiecken. - Nur Principled-BSDF-Grundfarben (Holz, dunkles Metall), keine Bildtexturen. - Wende die Modifikatoren an, verbinde alles zu einem Objekt namens "Crate". - Prüfe es mit dem look-Tool aus mehreren Winkeln und behebe alles, was schwebt. - Wähle nur "Crate" aus und exportiere es als GLB nach ./public/models/crate.glb. Zeig mir jedes Skript, bevor du es ausführst.Das Export-Skript lesen, bevor es läuft
Der Export endet meist mit einem Aufruf wie diesem, mit Parametern aus Blenders
export_scene-API. GLB packt Mesh, Materialien und Texturen in eine Datei. Prüfe, dass der Pfad innerhalb deines Projekts liegt.import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # eine Binärdatei mit Mesh, Materialien und Bildern use_selection=True, # nur die ausgewählte "Crate" export_apply=True, # Modifikatoren beim Export anwenden export_yup=True, # +Y oben )
Ist Blender MCP sicher? Was du absichern solltest
Behandle es, als würdest du dem Agenten eine Python-Shell in Blender geben. Diese Punkte stammen aus dem README von mcp-for-blender.
- Beliebiges Python:
execute_blender_codeführt jedes Python aus, das der Agent schreibt. Das README nennt das potenziell gefährlich und sagt, du sollst vorher immer deine Arbeit speichern. Lies Skripte, bevor du sie freigibst. - Safe Mode: Setze
BLENDER_MCP_SAFE_MODE=1, um Skripte vor der Ausführung zu prüfen. Er blockiert direktes Lesen und Schreiben von Dateien, das Starten anderer Programme, Netzwerkzugriff und persistenten Code; Modellieren, Materialien, Rendern, Speichern und Import/Export funktionieren weiter. - Keine Socket-Authentifizierung: Der Server des Add-ons (standardmäßig Port 9876) hat weder Authentifizierung noch Verschlüsselung, sodass jeder, der diesen Port erreicht, Python in Blender ausführen kann. Lass
BLENDER_HOSTauflocalhost, außer du bist in einem vertrauenswürdigen Netzwerk. - Telemetrie: Standardmäßig sendet es eine anonyme Installations-ID, eine Session-ID, den Tool-Namen, Erfolg, Dauer, Versionen, Betriebssystem und Zeitstempel. Prompts, generierter Code, Screenshots und Szenendaten werden nur gesendet, wenn du dem zustimmst, und zugestimmte Daten können zum Training von KI-Modellen verwendet werden. Setze
DISABLE_TELEMETRY=true, um sie ganz abzuschalten. - Schlüssel von Drittanbietern: 3D-Generierung und manche Asset-Quellen nutzen API-Schlüssel, die als Umgebungsvariablen übergeben werden (zum Beispiel
BLENDERMCP_MESHY_API_KEY). Rund 69 % der Poly-Pizza-Modelle stehen unter CC-BY, die Namensnennung ist also Pflicht, sofern du nicht auf CC0 filterst.
Blender MCP oder ein Blender-Skill?
Ein MCP-Server gibt dem Agenten eine Live-Verbindung zu einem laufenden Blender. Ein Skill gibt ihm schriftliche Anweisungen und Skripte für einen Workflow, etwa EL4CTEO/blender-skills (28 Workflow-Skills für Blender 5.2 LTS+ für Claude Code, Codex und andere). Beides ergänzt sich gut: Der Skill sagt dem Agenten, wie er ein spieltaugliches Asset baut, der MCP-Server lässt ihn das in deiner geöffneten Szene tun.
Wir listen Blender- und Spieleentwicklungs-Skills und MCP-Server unter Skills für die Spieleentwicklung, und vibegamer.io vergleicht sie in game dev agent skills.
Crewmark: ein 3D-Artist auf demselben Board wie deine Coder
Blender MCP ist auf eine Session nach der anderen ausgelegt: Du gibst den Prompt, der Agent modelliert, du prüfst. Wenn du einen Agenten willst, der über Tage hinweg weiter Assets erstellt, während andere den Spielcode schreiben, ist Crewmark eine weitere Option.
In Crewmark ist jeder Agent ein KI-Mitarbeiter: eine langlaufende Session mit einer Rolle, die auf deinem eigenen Rechner läuft. Claude-Code- und Codex-Mitarbeiter laufen nativ; andere Agenten, etwa OpenCode, DeepSeek Harness und Gemini, binden sich über ACP (acpx) an. Die Arbeit läuft über ein gemeinsames Issue-Board, auf dem du und die Mitarbeiter Issues zuweisen, kommentieren, einander per @-Erwähnung ansprechen und Status ändern. So bittet ein Coding-Mitarbeiter einen Blender-Mitarbeiter um ein neues Requisit: Er erwähnt ihn per @ im Issue. Mitarbeiter wachen nach Zeitplan (Heartbeats) und immer dann auf, wenn sie erwähnt werden, sodass die Arbeit startet, ohne dass du sie weiterreichen musst.
Es ersetzt Blender MCP nicht; ein Mitarbeiter mit installiertem Server nutzt ihn weiterhin. Es ergänzt die Rollen, das Board und das Aufwecken darum herum.
FAQ
Ist Blender MCP kostenlos?
Ja. mcp-for-blender ist Open Source unter MIT, und laut seiner Website funktioniert im kostenlosen Tarif jede Funktion außer der 3D-Generierung, die einen Premium-Tarif (ab 10 $ im Monat) oder deine eigenen API-Schlüssel eines Anbieters braucht. Der Server von Blender Lab ist kostenlos unter GPL-3.0.
Ist Blender MCP sicher?
Es führt jedes Python, das der Agent schreibt, in Blender aus, und sein Socket-Server hat keine Authentifizierung. Speichere zuerst deine Arbeit, lies Skripte vor der Freigabe, belasse es auf localhost und setze BLENDER_MCP_SAFE_MODE=1, um Dateizugriff, andere Programme und Netzwerkzugriff zu blockieren. Setze DISABLE_TELEMETRY=true, um die Nutzungstelemetrie abzuschalten.
Gibt es einen offiziellen Blender-MCP-Server?
Ja. Blender Lab veröffentlicht blender_mcp auf projects.blender.org (GPL-3.0, Blender 5.1+), und er ist im Connector-Verzeichnis von Claude als von Blender Lab erstellt aufgeführt. Das beliebte mcp-for-blender ist ein Drittanbieter-Projekt ohne Verbindung zur Blender Foundation.
Wie füge ich Blender MCP zu Claude Code hinzu?
Installiere uv, führe claude mcp add blender uvx mcp-for-blender aus, prüfe es mit claude mcp list, und installiere und aktiviere dann das Blender-Add-on mit uvx mcp-for-blender install-addon. Oder nutze den Ein-Befehl-Installer aus dem README, der Claude Code für dich einrichtet.
Wie füge ich Blender MCP zu Codex hinzu?
Führe codex mcp add blender -- uvx mcp-for-blender aus, oder füge ~/.codex/config.toml eine Tabelle [mcp_servers.blender] mit command = "uvx" und args = ["mcp-for-blender"] hinzu. CLI, Desktop-App und IDE-Erweiterung teilen sich diese Datei. Das README bietet außerdem ein Codex-Plugin mit Live-Viewport im Chat.
Soll ich Blender MCP oder einen Blender-Skill nutzen?
Nutze MCP, wenn der Agent auf eine laufende Blender-Szene einwirken soll; nutze einen Skill, wenn du ihm einen erprobten Workflow vorgeben willst. Viele Setups nutzen beides: Der Skill beschreibt den Workflow, der MCP-Server führt ihn aus.
Befehle und Funktionen am 21. November 2026 geprüft anhand des README von mcp-for-blender, des Repositorys und Wikis von Blender Labs blender_mcp, der MCP-Dokumentation von Claude Code und Codex sowie der glTF-Export-Dokumentation von Blender. Die Installationsbefehle haben wir nicht ausgeführt.