À propos du projet

MCP pour Blender est un plugin communautaire qui connecte Blender 3D à n'importe quel LLM (comme Claude, Codex ou Cursor) via le Model Context Protocol (MCP). Il permet de créer, modifier et manipuler des scènes 3D à l'aide de requêtes en langage naturel. ## Fonctionnalités principales - **Communication bidirectionnelle** : connecter des assistants IA à Blender via un serveur basé sur des sockets - **Manipulation d'objets** : créer, modifier et supprimer des objets 3D - **Contrôle des matériaux** : appliquer et modifier les matériaux et les couleurs - **Exécution de code** : exécuter du code Python arbitraire dans Blender depuis l'IA - **Génération d'assets et de modèles** : importer depuis Poly Haven, Sketchfab, Poly Pizza et des modèles générés par IA via Hyper3D Rodin et Hunyuan3D ## Comment ça marche Le plugin se compose de deux parties principales : 1. **Serveur MCP** (`src/blender_mcp/server.py`) – un serveur Python implémentant le Model Context Protocol 2. **Addon Blender** – un panneau latéral dans la vue 3D de Blender qui démarre la connexion ## Configuration 1. Installer `uv` (le gestionnaire de paquets Python) à l'aide de l'installateur officiel 2. Installer l'addon Blender (soit en ligne de commande, soit manuellement via les préférences de Blender) 3. Configurer votre client MCP (Claude Desktop, Claude Code, Codex, Cursor, VS Code, etc.) 4. Dans Blender, appuyer sur `N` pour ouvrir le panneau latéral, trouver l'onglet **MCP pour Blender** et cliquer sur **Démarrer le serveur MCP** ## Capacités - Exécuter n'importe quel code Python dans Blender - Télécharger des modèles, assets et HDRI depuis Poly Haven - Rechercher et télécharger des modèles depuis Sketchfab - Rechercher et télécharger des modèles low-poly depuis Poly Pizza - Générer des modèles 3D via Hyper3D Rodin et Hunyuan3D (Tencent Cloud) ## Exemples de commandes - « Créer une scène low poly dans un donjon, avec un dragon gardant un pot d'or » - « Donne une image de référence et crée une scène Blender à partir de celle-ci » - « Génère un modèle 3D d'un nain de jardin via Hyper3D » - « Remplis cette pièce avec des meubles low-poly de Poly Pizza » ## Configuration Les variables d'environnement permettent la personnalisation : - `BLENDER_HOST` (défaut : `localhost`) - `BLENDER_PORT` (défaut : `9876`) - `BLENDER_MCP_SAFE_MODE` – définir sur `1` pour valider les scripts avant exécution ## Considérations de sécurité - Le serveur de socket de l'addon n'a ni authentification ni chiffrement - Par défaut, l'IA peut exécuter n'importe quel code Python dans Blender - Le mode sécurisé (`BLENDER_MCP_SAFE_MODE=1`) bloque les opérations risquées comme les entrées/sorties de fichiers, l'accès réseau ou l'installation persistante de code ## Informations d'identification API persistantes Stockez les clés API pour Sketchfab, Poly Pizza, Hyper3D et Hunyuan3D dans les préférences de Blender ou via des variables d'environnement pour les configurations headless/CI. ## Support Docker Le serveur MCP peut être exécuté dans un conteneur au lieu d'être installé localement. Blender reste sur votre machine ; le conteneur héberge uniquement le serveur MCP et se connecte à l'addon Blender. ## Avertissement Ceci est une intégration tierce, non réalisée par Blender.