Partie 1 : Découverte générale et fonctionnelle
adresse du dépôt GitHub : https://github.com/ahujasid/blender-mcp?tab=readme-ov-file
Objectif principal du projet
BlenderMCP est un projet open-source qui connecte Blender, un logiciel de modélisation 3D, à Claude AI via le Model Context Protocol (MCP). L’objectif est de permettre aux utilisateurs de contrôler Blender à l’aide de commandes en langage naturel, facilitant ainsi la création, la manipulation et la gestion de scènes 3D grâce à l’intelligence artificielle.
Fonctionnalités clés
- Contrôle par langage naturel : Utiliser des instructions textuelles pour créer ou modifier des objets 3D, appliquer des matériaux, ou gérer des scènes.
- Manipulation d’objets : Créer, modifier ou supprimer des objets 3D dans Blender.
- Gestion des matériaux : Appliquer des textures, shaders et couleurs via des commandes IA.
- Inspection de scènes : Obtenir des informations détaillées sur la scène Blender actuelle.
- Exécution de code : Lancer des scripts Python directement dans Blender via Claude.
- Intégration Poly Haven : Accéder à des assets 3D (HDRIs, textures, modèles) depuis Poly Haven.
- Hyper3D Rodin : Générer des modèles 3D via l’intégration Hyper3D (avec clé API).
Public cible et cas d’usage
- Artistes 3D et designers : Pour automatiser des tâches répétitives ou complexes dans Blender.
- Débutants en 3D : Pour créer des scènes sans maîtriser l’interface ou le scripting Python.
- Développeurs et chercheurs en IA : Pour explorer les interactions entre IA et outils créatifs.
- Cas d’usage : Création de scènes pour des jeux, prototypage rapide de concepts 3D, ou génération de modèles pour des projets artistiques.
Utilisation et combinaison des fonctionnalités
- Création simple : Demander à Claude de créer un objet (ex. « Ajoute un cube au centre »).
- Modification avancée : Combiner des commandes comme « Change la couleur du cube en bleu » et « Applique une texture de bois depuis Poly Haven ».
- Inspection et ajustement : Vérifier les détails d’un objet, puis ajuster sa position ou sa taille.
- Automatisation : Exécuter un script Python pour des opérations complexes (ex. animation d’un objet).
- Exemple combiné : Créer une scène de plage en ajoutant des rochers et de la végétation depuis Poly Haven, ajuster l’éclairage avec un HDRI, et animer un personnage.
Exemples concrets d’utilisation
- Prototypage rapide : Un game designer demande à Claude de créer une scène forestière avec des arbres et un lac, puis ajuste les matériaux pour un rendu réaliste.
- Animation : Un étudiant en animation utilise BlenderMCP pour poser des keyframes sur un personnage et générer une marche simple.
- Design d’intérieur : Un architecte importe un modèle de chaise depuis Poly Haven, le place dans une pièce, et ajuste les couleurs pour un client.
- Expérimentation : Un développeur teste l’exécution d’un script Python pour automatiser la création de 100 cubes disposés en grille.
Avantages par rapport aux solutions similaires
- Accessibilité : Simplifie l’utilisation de Blender pour les non-experts, contrairement à l’interface native ou à des scripts manuels.
- Intégration IA : Offre une interaction en langage naturel, absente dans des plugins comme Animation Nodes.
- Poly Haven et Hyper3D : Accès direct à des ressources externes, un avantage par rapport à des outils comme blender-open-mcp qui nécessitent des configurations supplémentaires.
- Open-source : Gratuit et modifiable, contrairement à des solutions commerciales comme 3D-Coat avec IA intégrée.
Partie 2 : Exploration technique et métriques clés
Structure générale du projet
- Fichiers principaux :
- addon.py : Addon Blender qui crée un serveur socket pour recevoir des commandes.
- src/blender_mcp/server.py : Serveur Python qui implémente le protocole MCP et se connecte à l’addon.
- main.py : Point d’entrée pour lancer le serveur.
- Technologies :
- Langage : Python 3.10+.
- Protocole : MCP sur sockets TCP avec JSON pour les commandes/réponses.
- Dépendances : asyncio, requests (pour Poly Haven), FastMCP pour le serveur.
Dépendances et outils
- Blender : Version 3.0+ (testé jusqu’à 4.3.2).
- Claude AI : Nécessite un compte Anthropic (abonnement payant).
- Outils externes : Poly Haven API, Hyper3D Rodin (avec clé API).
- Gestion : uv (alternative à pip), compatible avec Windows, Mac, et Linux.
Activité récente
- Contributeurs : Principalement Siddharth Ahuja (ahujasid), avec des contributions communautaires (ex. harrywang pour Cursor).
- Mises à jour : Dernière mise à jour notable le 17 mars 2025, avec un PR merged le 11 avril 2025 (Cursor UI).
- Issues ouvertes : Plusieurs signalées (ex. erreurs AsyncIO, problèmes de connexion sur Windows), environ 10-15 issues actives.
- Fréquence : Activité modérée, avec des correctifs et améliorations régulières.
Qualité de la documentation et installation
- Documentation : README détaillé avec instructions d’installation pour Mac, Windows, et Linux. Inclut des démos (ex. création d’une scène de plage). Cependant, certains aspects (ex. gestion des erreurs) manquent de clarté.
- Facilité d’installation : Relativement simple pour les utilisateurs techniques : installer l’addon dans Blender, configurer Claude, et lancer le serveur. Problèmes fréquents de connexion (ex. AsyncIO sur Fedora, ProactorEventLoop sur Windows).
- Exemple : Ajouter le serveur MCP dans Claude via claude_desktop_config.json et lancer via Blender.
Popularité
- Étoiles et forks : 6k étoiles (selon un post X de @sidahuj le 17 mars 2025), nombre de forks non précisé mais probablement quelques centaines.
- Tendances : Croissance rapide, portée par l’intérêt pour l’IA et la 3D, soutenue par une communauté active (ex. Discord).
Partie 3 : Recherche complémentaire et contexte externe
Avis, tutoriels, articles
- Tutoriels : Une vidéo YouTube « Blender MCP: Setup Instructions » (12 mars 2025) détaille l’installation.
- Sites : blender-mcp.com offre des guides et exemples d’utilisation (ex. intégration OpenRouter).
- X : Sentiment positif, avec des utilisateurs comme @riku_ai_chatgpt (25 avril 2025) louant la facilité de création 3D.
Retours d’utilisateurs
- Points forts : Simplicité pour les débutants, puissance pour l’automatisation (ex. @frontboat sur X).
- Critiques : Problèmes de connexion récurrents (issues #11, #52), surtout sur Windows et Fedora.
- Communauté : Support actif via Discord et GitHub issues.
Projets et alternatives associés
- blender-open-mcp : Utilise Ollama pour des modèles locaux, mais moins intégré avec Claude.
- Blender MCP VXAI : Similaire, mais met l’accent sur des fonctionnalités comme l’animation.
- Outils associés : OpenRouter pour d’autres modèles IA, server-sequential-thinking pour des workflows complexes.
- Alternatives : Plugins Blender traditionnels (ex. Geometry Nodes), mais sans IA.
Roadmap et pistes d’évolution
- Améliorations : Résoudre les problèmes AsyncIO, améliorer la compatibilité Windows.
- Fonctionnalités : Ajouter des commandes pour l’animation avancée ou l’export vers d’autres formats.
- Communauté : Développer des tutoriels vidéo et des démos plus poussées.
Partie 4 : Synthèse et recommandations
3 points clés innovants
- Contrôle par langage naturel : Simplifie la 3D pour les non-experts.
- Intégration Poly Haven/Hyper3D : Accès direct à des ressources externes.
- Exécution de scripts : Automatisation puissante pour les utilisateurs avancés.
Cas d’usage typiques
- Création rapide de scènes pour des jeux ou des films.
- Prototypage de concepts 3D pour des présentations.
- Apprentissage de Blender pour les débutants via des commandes simples.
Pistes d’amélioration
- Améliorer la stabilité sur Windows et Linux.
- Ajouter un mode hors-ligne avec des modèles locaux (ex. via Ollama).
- Développer une interface graphique pour gérer les commandes.
