Analyser une scène avec Blender MCP Server : installation et prompts sûrs

Ce que vous apprendrez dans ce guide

Blender MCP Server est une intégration qui permet de connecter une session Blender à un client utilisant le Model Context Protocol (MCP). Selon la page officielle de Blender, cet outil aide à utiliser l’API Python de Blender en langage naturel et à comprendre des scènes complexes. Ce guide présente les composants nécessaires, des exemples de prompts pour examiner une scène et des conseils pour évaluer les résultats avec prudence.

Les prompts ci-dessous s’inspirent des cas d’usage présentés dans le guide officiel : analyse de scène, relations entre objets et matériaux, et explication de Geometry Nodes. Un prompt ne garantit pas un résultat exact : dans les exemples de Blender, la réussite varie selon le modèle utilisé. Vérifiez les résultats avant d’appliquer toute modification au fichier.

Prérequis et sécurité

Blender 5.1 ou une version ultérieure est nécessaire. Blender ne disposant pas d’une fonction intégrée pour se connecter aux LLM, trois composants externes doivent être téléchargés, installés et lancés séparément :

• L’extension d’intégration Blender MCP

• Un client LLM

• MCP Server

La préparation du client MCP dépend du logiciel utilisé. Le guide Blender recommande de suivre la documentation de Llama.cpp ou d’installer un autre client de votre choix. Une option MCP Bundle au format .mcpb est également disponible pour les nouveaux clients ; le guide précise que Llama.cpp ne prend pas encore en charge ce paquet. Pour une installation à partir du code source, suivez les instructions d’installation correspondantes.

Considérez l’avertissement de sécurité comme une étape indispensable de l’installation. Selon la page de Blender, MCP Server peut exécuter dans Blender le code généré par le LLM sans protection contre la suppression de données ou leur envoi vers un emplacement distant. L’équipe Blender recommande donc d’utiliser une machine virtuelle ou un système qui n’a pas accès à des informations sensibles. Ajouter « ne modifie pas la scène » au prompt ne remplace pas cette mesure de sécurité.

Installation et utilisation, étape par étape

1. Installer l’extension Blender

Procurez-vous l’extension nécessaire à l’intégration de MCP Server. Si vous souhaitez ajouter le dépôt Blender Lab et l’extension par glisser-déposer, l’opération se déroule en deux étapes : ajoutez d’abord le dépôt, puis l’extension. La page officielle indique que cette méthode permet de recevoir des notifications de mise à jour de l’extension. Autre possibilité : télécharger l’extension et l’installer via « Install from Disk ». Ces deux méthodes figurent parmi les options décrites dans le guide Blender ; ne présumez pas que les détails sont identiques d’une version à l’autre.

2. Préparer le client et MCP Server

Vérifiez la méthode de prise en charge de MCP Server par le client LLM que vous comptez utiliser. Si le client prend en charge les paquets .mcpb, vous pouvez utiliser MCP Bundle ; sinon, reportez-vous aux instructions d’installation correspondant au code source ou au client. Une fois l’extension Blender, le client et le serveur prêts, vous pouvez configurer MCP Server dans le client et le lancer. Les détails variant selon le client, ne partez pas du principe que la procédure est la même pour tous les logiciels.

3. Limiter le premier essai à une analyse sans modification

Une fois la connexion établie, commencez par demander un examen qui ne modifie pas la scène. Par exemple, le prompt suivant recherche les objets qui ont un nombre élevé de polygones, mais semblent petits depuis la caméra :

Analyze the current Blender scene. List objects with a high polygon count that appear small from the active camera's point of view, and explain why they may be optimization candidates. Do not modify the scene; report findings only.

Cette requête vise à évaluer le nombre de polygones en fonction de la taille apparente dans la caméra. L’exemple Blender compare également le nombre de polygones à la surface occupée dans le rendu final. La consigne « ne modifie pas la scène » reste une demande : elle n’élimine pas le risque lié à l’exécution de code. Vérifiez manuellement les éléments signalés dans la scène.

4. Trouver les objets qui utilisent un matériau

Pour savoir à quels objets un matériau donné est associé, indiquez explicitement son nom dans le prompt. Ce type de requête figure parmi les cas d’usage présentés par Blender :

In the current Blender file, list the objects that use the material named "pebbles". Include only objects you can verify from the scene data, and do not change the file.

pebbles est le nom de matériau utilisé dans l’exemple du guide officiel. Dans une autre scène, remplacez-le par le nom réel du matériau recherché. Comparez la liste obtenue aux données de la scène : le prompt illustre comment formuler la requête, mais ne garantit pas le même résultat avec tous les modèles.

5. Faire expliquer un agencement Geometry Nodes

Pour comprendre un groupe de nœuds complexe, précisez dans le prompt quel agencement examiner et le type d’explication souhaité. Le guide Blender propose un exemple qui consiste à expliquer un setup Geometry Nodes et à enregistrer le résultat dans un Text data-block :

Explain what the main Geometry Nodes setup in the current Blender file does. Describe the purpose of its major parts and how the geometry flows through the setup. Add documentation frames to the node setup and create a Text data-block containing the explanation. Do not change other parts of the scene.

Ce prompt demande de créer un document et de modifier l’agencement des nœuds. Essayez-le d’abord sur une copie de sauvegarde de la scène. Comparez le résultat au groupe de nœuds et vérifiez notamment que les connexions et les descriptions sont correctement retranscrites. L’exemple officiel précise également que la réussite dépend du modèle utilisé.

Erreurs fréquentes

• S’en remettre au texte du prompt pour la sécurité : demander de « ne pas modifier le fichier » n’empêche pas les risques liés à l’exécution du code généré par le LLM. Privilégiez un environnement sans accès aux fichiers de projet sensibles.

• Tenir le résultat de l’analyse pour certain : dans l’exemple officiel, la première analyse des polygones n’évalue pas complètement l’effet des modifiers dans la vue. Comparez les résultats aux paramètres de la scène.

• Présumer de la compatibilité du client : le paquet .mcpb n’est pas pris en charge par tous les clients ; le guide signale explicitement cette limitation pour Llama.cpp. Choisissez une méthode adaptée au client utilisé.

• Commencer par des prompts qui demandent des modifications : renommer des éléments ou documenter un agencement de nœuds peut modifier les données de la scène. Commencez par examiner et vérifier les résultats.

Quelle place dans les workflows d’architecture et de visualisation ?

Dans une scène d’architecture, repérer les objets très polygonisés mais de petite taille dans le cadre peut aider à examiner les pistes d’optimisation. Une requête sur les matériaux permet de mieux comprendre les relations dans la scène ; l’explication de Geometry Nodes peut faciliter l’analyse d’un agencement hérité d’un autre utilisateur ou qui n’a pas été mis à jour depuis longtemps. Ces usages peuvent soutenir l’évaluation de l’artiste ou du responsable technique ; ne considérez pas les résultats automatiques comme des décisions de production définitives.

Le guide ne précise aucun besoin matériel, prix ou coût de licence. Les agences doivent donc vérifier séparément les conditions d’utilisation du client et du modèle, et préparer un environnement de test sécurisé avant toute expérimentation sur des fichiers importants. Il faut également contrôler la compatibilité entre la version de Blender, l’extension et le client avant l’installation.

Étapes suivantes

Commencez par essayer, dans une scène de test, un prompt d’inspection sans modification, comme une recherche d’objets par matériau. Comparez ensuite le résultat de l’analyse aux données de la scène dans Blender. Si vous passez à des prompts qui demandent des modifications du fichier, testez-les dans un environnement isolé et sur une copie. Pour rechercher où lire une propriété dans l’API Python de Blender, la référence officielle de l’API peut aider à comprendre la différence entre bpy.context, qui donne accès au contexte utilisateur, et bpy.data, qui donne accès aux données du fichier blend.

Sources et licence

Le guide « MCP Server » de Blender a servi de référence pour les composants à installer, les avertissements de sécurité et les exemples d’utilisation. Le document Blender API Reference Usage a été utilisé pour les explications sur l’accès aux données de l’API et la consultation de la référence ; son contenu a été adapté en turc sous licence CC BY-SA 4.0.