Blender MCP — Cas d'usage, Installer & Démo en direct

Name: Blender MCP MCP Server
Author: ahujasid

Pourquoi l'utiliser

Fonctionnalités clés

Exécution directe bpy — tout ce que vous pouvez scripter, Claude peut le piloter
Introspection de scène : lister les objets, obtenir les propriétés, inspecter les matériaux
Intégration PolyHaven : rechercher et importer des HDRIs, textures, modèles
Hyper3D rodin : générer des modèles 3D par IA depuis du texte ou une image
Recherche Sketchfab intégrée pour parcourir des modèles gratuits

Démo en direct

Aperçu en pratique

blender-mcp-ahujasid.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Blender MCP

Construire une scène 3D depuis un prompt textuel sans toucher l'interface Blender

👤 Designers, développeurs indépendants, amateurs qui ne maîtrisent pas la modélisation ⏱ ~30 min beginner

Quand l'utiliser : Vous voulez une maquette 3D rapide mais ne voulez pas apprendre les raccourcis Blender.

Prérequis

Blender 3.0+ installé — Télécharger depuis blender.org
Addon Blender MCP activé — Edit > Preferences > Add-ons > Install from disk

Déroulement

Connecter Claude à Blender

Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ Copié

→ Scène vide listée (Cube, Camera, Light) confirmant la connexion live
Composer la scène

Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ Copié

→ Objets apparaissant dans le viewport en temps réel
Ajouter de l'atmosphère

Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ Copié

→ La scène a maintenant une atmosphère éclairée ; le brouillard visible au rendu

Résultat : Une scène 3D prototype construite entièrement via le chat, prête à être affinée.

Pièges

Blender se déconnecte en milieu de session — Reconnectez depuis le N-panel ; l'addon écoute sur un socket local

Générer des assets 3D avec Hyper3D rodin et les importer directement

👤 Développeurs de jeux et prototypeurs ayant besoin d'itérations rapides sur les assets ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez besoin d'un prop unique et ne voulez pas le modéliser de zéro ni payer des assets de marketplace.

Prérequis

Clé API Hyper3D rodin (tier gratuit disponible) — Inscrivez-vous sur hyper3d.ai ; définissez HYPER3D_RODIN_API_KEY

Déroulement

Générer depuis un prompt

Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ Copié

→ Tâche de génération lancée ; mesh importé quand terminé (~30s)
Affiner et réimporter si nécessaire

The mesh is too dense. Decimate to 5k tris and reimport.✓ Copié

→ Mesh décimé remplace l'original

Résultat : Prop 3D personnalisé dans la scène, généré et ajusté sans quitter Claude.

Pièges

File d'attente de génération saturée sur le tier gratuit — Réessayez avec un backoff exponentiel ou montez en tier

Exécuter des opérations en masse sur de nombreux objets via bpy

👤 TDs et ingénieurs pipeline ⏱ ~25 min advanced

Quand l'utiliser : Vous avez besoin d'une action groupée fastidieuse — renommer la hiérarchie, recibler les matériaux, déplier les UVs en lot.

Déroulement

Décrire l'opération

Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ Copié

→ Claude écrit le snippet bpy, demande confirmation avant d'exécuter
Exécuter avec filet de sécurité

Show me the script first. If it looks safe, execute. Otherwise revise.✓ Copié

→ Script visible ; exécution appliquée ; rapport du nombre d'objets affectés

Résultat : Opérations de scène en masse effectuées en secondes avec piste d'audit complète.

Pièges

Un mauvais script plante Blender — Sauvegardez avant toute exécution bpy ; l'addon n'isole pas l'exécution

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

blender-mcp-ahujasid + filesystem

Sauvegarder les rendus et exports sur disque

After rendering, save the PNG to ~/Renders/today.png via filesystem MCP.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
execute_blender_code	code: str	Toute opération bpy directe	0
get_scene_info	()	Premier appel pour comprendre ce qui est dans la scène	0
get_object_info	name: str	Inspecter un objet spécifique avant de le modifier	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	Trouver des assets PBR gratuits	0
polyhaven_download_asset	asset_id, resolution	Récupérer et appliquer un HDRI/texture	0
generate_hyper3d_model_via_text	prompt: str	Générer un modèle 3D par IA	1 generation credit

Coût et limites

Coût d'exécution

Quota d'API: PolyHaven : illimité gratuit. Hyper3D : tier gratuit ~20 générations/jour
Tokens par appel: 100–800 par appel (l'état de scène peut être verbeux)
Monétaire: Addon gratuit. Tiers payants Hyper3D à partir de 10$/mois
Astuce: Utilisez Sketchfab et PolyHaven avant de payer des générations Hyper3D

Sécurité

Permissions, secrets, portée

Portées minimales : blender-bpy-exec filesystem-write (for downloads)

Stockage des identifiants : Clé Hyper3D en variable d'environnement

Sortie de données : CDN PolyHaven, API Hyper3D

execute_blender_code exécute du Python arbitraire dans votre Blender — relisez avant d'exécuter des scripts inconnus

Dépannage

Erreurs courantes et correctifs

Connection refused

Assurez-vous que Blender est ouvert et que le 'Connect to Claude' de l'addon est activé ; port par défaut 9876

La génération Hyper3D se bloque

Vérifiez la variable d'env HYPER3D_RODIN_API_KEY ; vérifiez le quota du tier sur hyper3d.ai

Objet introuvable après modification

Le nom de l'objet peut avoir un suffixe numérique (.001) — utilisez get_scene_info pour rafraîchir

Alternatives

Blender MCP vs autres

Alternative	Quand l'utiliser	Compromis
Unity MCP / Unreal MCP	Votre pipeline est d'abord centré sur un moteur de jeu, pas sur un DCC	Les MCPs moteur ciblent le runtime/la scène ; Blender MCP cible l'authoring
Cesium MCP	Vous avez besoin de 3D géospatial/à l'échelle mondiale	Cesium est pour les scènes géoréférencées ; Blender est freeform

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills