Ce qu’est Blender MCP
MCP (Model Context Protocol) donne à un agent des outils qui agissent sur un autre programme. Les deux projets Blender MCP ont les mêmes deux éléments : un add-on qui fait tourner un petit serveur dans Blender, et un serveur MCP que votre agent démarre et qui transmet ses appels d’outils à l’add-on sous forme de JSON sur un socket TCP.
Le projet que la plupart des gens ont en tête est mcp-for-blender. Son README s’ouvre sur un avertissement : c’est une intégration tierce, qui n’est pas faite par Blender. Il est sous licence MIT, avait 35 153 étoiles GitHub le 21 novembre 2026, et son paquet PyPI est passé de blender-mcp à mcp-for-blender (version 2.3.1 le 18 novembre) ; uvx blender-mcp démarre toujours le serveur, donc les anciennes configurations continuent de marcher.
Le blender_mcp de Blender Lab est le serveur officiel. Son readme le présente comme un serveur léger, volontairement petit, qui vise une interface en langage naturel pour l’API Python de Blender, un meilleur accès à la documentation et l’exploration de scènes complexes. Il figure dans le répertoire de connecteurs de Claude sous le nom Blender, créé par Blender Lab, vérifié par Anthropic.
mcp-for-blender face au blender_mcp de Blender Lab
Chiffres tirés des dépôts GitHub et projects.blender.org au 21 novembre 2026.
| mcp-for-blender (communautaire) | blender_mcp (Blender Lab) | |
|---|---|---|
| Auteur | Siddharth Ahuja ; sans lien avec la Blender Foundation | Blender Lab, qui fait partie du projet Blender |
| Licence | MIT | GPL-3.0 |
| Version de Blender | 3.0 ou plus récente | 5.1 ou plus récente |
| Étoiles | 35 153 sur GitHub | 39 sur projects.blender.org |
| Outils | Neuf, dont execute_blender_code, look (vues de la fenêtre 3D et de la caméra), get_scene_info, recherche et import d’assets (Poly Haven, Sketchfab, Poly Pizza) et generate_3d (Tripo, Hunyuan3D, Hyper3D Rodin, Meshy) | execute_blender_code, execute_blender_code_for_cli (Blender en arrière-plan), résumés de fichiers blend et d’objets, get_python_api_docs, captures d’écran ; inclut des extraits de l’API Python et du manuel |
| Installation | Installeur en une commande ou uvx mcp-for-blender ; configuration intégrée pour Claude Code, Codex, Cursor et d’autres | git clone du dépôt et lancement avec uv ; ajout de l’add-on dans Blender |
| Idéal pour | Construire et habiller des scènes, importer des assets, générer des modèles | Inspecter des fichiers et poser des questions sur l’API de Blender, sur une version récente de Blender |
Installation rapide : tous vos agents d’un coup
La voie recommandée par le README de mcp-for-blender tient en une commande. Elle installe uv si besoin, repère les clients MCP présents sur votre machine (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), vous laisse choisir lesquels configurer, puis installe et active l’add-on Blender. Elle ajoute seulement une entrée blender à chaque configuration et garde un .bak de chaque fichier modifié. Ensuite, quittez complètement votre agent et rouvrez-le.
Les commandes ci-dessous sont copiées du README ; nous ne les avons pas exécutées. Envoyer un script dans votre shell par un pipe l’exécute avec vos droits : si vous préférez voir chaque étape, utilisez plutôt l’installation manuelle des deux sections suivantes.
- 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 - Avec uv déjà installé :
uvx mcp-for-blender setup - Il vous faut Blender 3.0 ou plus récent, Python 3.10 ou plus récent, et uv.
Installer Blender MCP dans Claude Code
Installation manuelle de mcp-for-blender. Les commandes sont copiées du README du projet et de la doc MCP de Claude Code ; nous ne les avons pas exécutées.
Installer uv
uv fournit la commande
uvxqui démarre le serveur. Le README déconseillepip install uv; utilisez l’installeur officiel.# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -eEnregistrer le serveur
Cela enregistre le serveur pour le projet courant. Ajoutez
--scope userpour l’utiliser partout ; les options de ce genre se placent avant un--qui les sépare de la commande du serveur, ce qui est la forme employée par la doc de Claude Code. Dans une session,/mcpaffiche le même état.# la commande du README claude mcp add blender uvx mcp-for-blender # vérifier : le serveur doit apparaître comme connecté claude mcp list claude mcp get blenderFacultatif : désactiver la télémétrie
Le README indique de définir
DISABLE_TELEMETRY=truedans l’environnement du serveur pour désactiver complètement la télémétrie. La commandeclaude mcp addde Claude Code accepte les variables d’environnement avec--env; voir la doc MCP de Claude Code pour la forme exacte.Installer et activer l’add-on Blender
Ensuite, dans Blender, ouvrez Edit → Preferences → Add-ons et activez « Interface: MCP for Blender ». Appuyez sur N dans la vue 3D et ouvrez l’onglet MCP for Blender ; le serveur démarre avec Blender, et s’il ne tourne pas, cliquez sur Start MCP Server.
# copie l’add-on dans le dossier des add-ons de Blender sous le nom blender_mcp.py (garde un .bak) uvx mcp-for-blender install-addon # liste les dossiers d’add-ons trouvés uvx mcp-for-blender addon-paths
Installer Blender MCP dans Codex
Le CLI Codex, l’appli de bureau et l’extension d’IDE partagent ~/.codex/config.toml : une seule installation couvre les trois. Les commandes sont copiées du README et de la doc MCP de Codex d’OpenAI ; nous ne les avons pas exécutées. Installez uv et l’add-on Blender comme dans les étapes de Claude Code.
Ajouter le serveur avec le CLI
Codex affiche les outils au prochain démarrage ;
/mcpdans l’interface terminal de Codex liste les serveurs actifs. Dans l’appli de bureau, c’est Settings → MCP servers → Add server, nomblender, STDIO, commandeuvx mcp-for-blender.# la commande du README codex mcp add blender -- uvx mcp-for-blender # vérifier : blender doit apparaître comme activé codex mcp listOu modifier config.toml
La table
[mcp_servers.blender]vient du README. La ligneenvsuit la doc de Codex, qui listeenv,startup_timeout_sec(10 par défaut) ettool_timeout_sec(60 par défaut) comme clés de table ; augmenteztool_timeout_secsi de longues opérations Blender expirent.# ou à la main dans ~/.codex/config.toml (partagé par le CLI Codex, l’appli de bureau et l’extension d’IDE) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]Facultatif : le plugin Codex
Le README le recommande pour Codex : il affiche une fenêtre Blender en direct dans le chat, des sélecteurs de miniatures pour les assets et des @-mentions pour les objets de la scène. Il n’est pas encore dans le répertoire des plugins Codex, vous l’ajoutez donc depuis le dépôt.
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # puis redémarrez Codex et installez « MCP for Blender » depuis le répertoire des plugins
Installer plutôt le serveur officiel de Blender Lab
Le wiki d’installation de Blender Lab vous fait installer son add-on dans Blender 5.1 ou plus récent, cloner le serveur dans votre dossier personnel et pointer votre client MCP dessus avec uv. Voici la commande de clonage et la configuration du wiki telles qu’enregistrées ; nous ne les avons pas exécutées. Si vous utilisez Claude, le serveur figure aussi dans le répertoire de connecteurs de Claude, qui précise que l’add-on est requis.
git clone https://projects.blender.org/lab/blender_mcp.git, puis {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}
N’enregistrez pas les deux projets sous le même nom blender. Le README de mcp-for-blender dit aussi de ne lancer qu’une seule instance de son serveur à la fois, par exemple dans Cursor ou Claude Desktop mais pas dans les deux.
Exemple : un agent construit un accessoire low-poly et exporte un GLB
Avec Blender ouvert et l’add-on en marche, l’agent fait la modélisation via execute_blender_code et contrôle son travail avec look. Nous avons écrit cet exemple d’après la doc sans l’exécuter de bout en bout : les résultats varieront. Pour compresser le GLB avec glTF-Transform et le charger dans three.js, voir le guide Blender MCP complet sur vibegamer.io.
Enregistrer votre fichier .blend
L’agent modifie directement votre fichier ouvert. L’avertissement du README : enregistrez toujours votre travail avant d’utiliser
execute_blender_code.Donner la consigne à l’agent
Précisez les dimensions, un budget de triangles et le chemin d’export. Les couleurs de base unies s’exportent proprement, car l’exporteur glTF de Blender lit la couleur de base dans le nœud Principled BSDF. Le README note aussi que les opérations complexes peuvent devoir être découpées en étapes plus petites.
Utilise les outils Blender MCP. Construis une caisse en bois low-poly pour un jeu navigateur : - cube de 1 m, posé au sol à z = 0, origine au centre du bas. - Planches biseautées et renforts d’angle, moins de 800 triangles. - Couleurs de base Principled BSDF uniquement (bois, métal sombre), pas de textures image. - Applique les modificateurs, fusionne tout en un seul objet nommé "Crate". - Vérifie-le avec l’outil look sous plusieurs angles et corrige tout ce qui flotte. - Sélectionne uniquement "Crate" et exporte-le en GLB vers ./public/models/crate.glb. Montre-moi chaque script avant de l’exécuter.Lire le script d’export avant son exécution
L’export se termine en général par un appel comme celui-ci, avec des paramètres de l’API
export_scenede Blender. Le GLB regroupe maillage, matériaux et textures dans un seul fichier. Vérifiez que le chemin est bien dans votre projet.import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # un seul fichier binaire avec maillage, matériaux et images use_selection=True, # uniquement la "Crate" sélectionnée export_apply=True, # appliquer les modificateurs à l’export export_yup=True, # axe Y vers le haut )
Blender MCP est-il sûr ? Ce qu’il faut verrouiller
Traitez-le comme si vous donniez à l’agent un shell Python dans Blender. Ces points viennent du README de mcp-for-blender.
- Python arbitraire :
execute_blender_codeexécute n’importe quel Python écrit par l’agent. Le README juge cela potentiellement dangereux et demande d’enregistrer toujours son travail avant. Lisez les scripts avant de les approuver. - Mode sûr : définissez
BLENDER_MCP_SAFE_MODE=1pour valider les scripts avant leur exécution. Il bloque la lecture et l’écriture directes de fichiers, le lancement d’autres programmes, l’accès réseau et le code persistant ; la modélisation, les matériaux, le rendu, l’enregistrement et l’import/export continuent de fonctionner. - Pas d’authentification sur le socket : le serveur de l’add-on (port 9876 par défaut) n’a ni authentification ni chiffrement, donc toute personne pouvant joindre ce port peut exécuter du Python dans Blender. Laissez
BLENDER_HOSTsurlocalhost, sauf sur un réseau de confiance. - Télémétrie : par défaut, il envoie un identifiant d’installation anonyme, un identifiant de session, le nom de l’outil, le succès, la durée, les versions, le système et l’horodatage. Les prompts, le code généré, les captures d’écran et les données de scène ne sont envoyés que si vous y consentez, et les données ainsi partagées peuvent servir à entraîner des modèles d’IA. Définissez
DISABLE_TELEMETRY=truepour la désactiver entièrement. - Clés tierces : la génération 3D et certaines sources d’assets utilisent des clés d’API passées en variables d’environnement (par exemple
BLENDERMCP_MESHY_API_KEY). Environ 69 % des modèles Poly Pizza sont en CC-BY : l’attribution est donc obligatoire, sauf si vous filtrez sur CC0.
Blender MCP ou une skill Blender ?
Un serveur MCP donne à l’agent une connexion en direct avec un Blender en cours d’exécution. Une skill lui donne des instructions écrites et des scripts pour un workflow, comme EL4CTEO/blender-skills (28 skills de workflow pour Blender 5.2 LTS+, pour Claude Code, Codex et d’autres). Les deux se complètent bien : la skill explique à l’agent comment construire un asset prêt pour le jeu, le serveur MCP lui permet de le faire dans votre scène ouverte.
Nous listons des skills et serveurs MCP pour Blender et la création de jeux dans skills pour le développement de jeux, et vibegamer.io les compare dans game dev agent skills.
Crewmark : un artiste 3D sur le même tableau que vos développeurs
Blender MCP est conçu autour d’une seule session à la fois : vous donnez la consigne, l’agent modélise, vous relisez. Si vous voulez un agent qui continue de produire des assets pendant des jours pendant que d’autres écrivent le code du jeu, Crewmark est une autre option.
Dans Crewmark, chaque agent est un employé IA : une session de longue durée dotée d’un rôle, qui tourne sur votre propre machine. Les employés Claude Code et Codex fonctionnent en natif ; d’autres agents, comme OpenCode, DeepSeek Harness et Gemini, se connectent via ACP (acpx). Le travail circule sur un tableau d’issues partagé, où vous et les employés assignez des issues, commentez, vous @mentionnez et changez les statuts. C’est ainsi qu’un employé développeur demande un nouvel accessoire à un employé Blender : il le @mentionne sur l’issue. Les employés se réveillent selon un planning (pulsations) et chaque fois qu’on les mentionne, si bien que le travail démarre sans que vous ayez à le transmettre.
Cela ne remplace pas Blender MCP ; un employé qui a le serveur installé continue de l’utiliser. Cela ajoute autour de lui les rôles, le tableau et les réveils.
FAQ
Blender MCP est-il gratuit ?
Oui. mcp-for-blender est open source sous licence MIT, et son site indique que toutes les fonctions marchent avec l’offre gratuite, sauf la génération 3D, qui demande une offre Premium (à partir de 10 $ par mois) ou vos propres clés d’API de fournisseur. Le serveur de Blender Lab est gratuit sous GPL-3.0.
Blender MCP est-il sûr ?
Il exécute dans Blender tout Python que l’agent écrit, et son serveur de socket n’a aucune authentification. Enregistrez d’abord votre travail, lisez les scripts avant de les approuver, gardez-le sur localhost, et définissez BLENDER_MCP_SAFE_MODE=1 pour bloquer l’accès aux fichiers, aux autres programmes et au réseau. Définissez DISABLE_TELEMETRY=true pour désactiver la télémétrie d’usage.
Existe-t-il un serveur Blender MCP officiel ?
Oui. Blender Lab publie blender_mcp sur projects.blender.org (GPL-3.0, Blender 5.1+), et il figure dans le répertoire de connecteurs de Claude comme créé par Blender Lab. Le populaire mcp-for-blender est un projet tiers, sans lien avec la Blender Foundation.
Comment ajouter Blender MCP à Claude Code ?
Installez uv, lancez claude mcp add blender uvx mcp-for-blender, vérifiez avec claude mcp list, puis installez et activez l’add-on Blender avec uvx mcp-for-blender install-addon. Ou lancez l’installeur en une commande du README, qui configure Claude Code pour vous.
Comment ajouter Blender MCP à Codex ?
Lancez codex mcp add blender -- uvx mcp-for-blender, ou ajoutez à ~/.codex/config.toml une table [mcp_servers.blender] avec command = "uvx" et args = ["mcp-for-blender"]. Le CLI, l’appli de bureau et l’extension d’IDE partagent ce fichier. Le README propose aussi un plugin Codex avec une fenêtre Blender en direct dans le chat.
Faut-il utiliser Blender MCP ou une skill Blender ?
Utilisez MCP quand l’agent doit agir sur une scène Blender en cours d’exécution ; utilisez une skill quand vous voulez lui donner un workflow éprouvé à suivre. Beaucoup de configurations utilisent les deux : la skill décrit le workflow et le serveur MCP l’exécute.
Commandes et fonctionnalités vérifiées d’après le README de mcp-for-blender, le dépôt et le wiki de blender_mcp de Blender Lab, la doc MCP de Claude Code et de Codex, et la doc d’export glTF de Blender le 21 novembre 2026. Nous n’avons pas exécuté les commandes d’installation.