SkillHub

blender-mcp

v1.0.0

Advanced bridge to Blender via MCP. Allows querying scene, creating objects, applying materials, and running custom BPY code in real-time.

Sourced from ClawHub, Authored by FlayZz

Installation

Please help me install the skill `blender-mcp` from SkillHub official store. npx skills add FlayZz/blender-mcp

Blender MCP Bridge

This skill connects Forge (blender_agent) directly to a running Blender instance.

Instructions

Cette skill est un Bridge MCP vers Blender. Tu ne dois pas coder la géométrie complexe à la main si un modèle existe.

🛡️ Professional Scripts Library (Standard Operating Procedures)

Avant de coder une solution ad-hoc, vérifie si un script maître existe dans ton dossier scripts/ :

  • camera_rig_master.py : Utilise-le pour créer un rig professionnel (Empty-based) pour des Orbits 360 ou des travellings stables.
  • studio_lighting.py : (À venir) Pour forcer une configuration de lumière standardisée.
  • animation_pro.py : (À venir) Pour appliquer des courbes d'accélération aux objets.

🛠️ Toolbox MCP

Utilise l'outil blender_mcp avec les paramètres suivants :

Tool Argument Description
search_sketchfab_models query (ex: "lock mechanism") Trouve des modèles pros sur Sketchfab.
download_sketchfab_model model_id Importe le modèle GLTF/FBX dans la scène.
search_polyhaven_assets query, asset_type (hdris) Trouve des éclairages réels.
download_polyhaven_asset asset_id Charge l'HDRI ou la Texture.
execute_code code (Python BPY) Le couteau suisse (Caméra, Rendu, Save).
get_scene_info (none) Liste les objets présents.

🚀 Workflow Opti pour "L'Expert 3D"

  1. Intelligence Scene : Utilise get_scene_info pour savoir ce qui est déjà là.
  2. Lumière Pro :
  3. Trouve un HDRI (PolyHaven) pour les reflets.
  4. Ajoute des AREA lights pour sculpter l'objet.
  5. Animation (Exploded View) : python # Exemple de keyframe obj.location = (0,0,0) obj.keyframe_insert(data_path="location", frame=1) obj.location = (1,0,0) obj.keyframe_insert(data_path="location", frame=40)
  6. Final Block (execute_code) : python import bpy # Rendu Transparent bpy.context.scene.render.film_transparent = True # Sauvegarde Master bpy.ops.wm.save_as_mainfile(filepath="./lock_master.blend") # Rendu image ou animation bpy.ops.render.render(write_still=True)

🎯 Monitoring

Sois bavard sur tes choix de lumières et d'angles. L'utilisateur veut une scène lumineuse et détaillée.

Usage

Use this skill whenever you need real-time feedback from Blender or complex modeling tasks.

Example: utilise blender_mcp avec tool="create_object" arguments='{"type": "MESH_CUBE", "name": "HeroBox"}'