← Back to Skills Marketplace
flayzz

Blender Mcp

by FlayZz · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
626
Downloads
1
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install blender-mcp
Description
Advanced bridge to Blender via MCP. Allows querying scene, creating objects, applying materials, and running custom BPY code in real-time.
README (SKILL.md)

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 :
    • Trouve un HDRI (PolyHaven) pour les reflets.
    • Ajoute des AREA lights pour sculpter l'objet.
  3. Animation (Exploded View) :
    # 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)
    
  4. Final Block (execute_code) :
    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"}'

Usage Guidance
This skill appears to be what it claims: a bridge to a local blender-mcp helper. Before installing, confirm you trust the 'uvx' / 'blender-mcp' binary that will be executed (the bridge launches that local binary via child_process). Be aware that the tool exposes execute_code which runs arbitrary Blender Python (BPY) — that can read/write files, run network requests if Blender allows them, or run any script in your scripts/ directory. To reduce risk: only use this skill with a trusted uvx/blender-mcp binary, run Blender in an isolated environment if possible, review any helper scripts in scripts/ and the BPY code being executed, and avoid providing it access to sensitive directories. If you don't plan to use execute_code or external asset downloads, consider removing or sandboxing those capabilities.
Capability Analysis
Type: OpenClaw Skill Name: blender-mcp Version: 1.0.0 The skill provides a bridge to Blender that includes an 'execute_code' tool, allowing for arbitrary Python (BPY) execution within the Blender environment. It also utilizes child_process.spawn with shell enabled on Windows to invoke 'uvx blender-mcp' (server.js), which introduces a risk of command injection and relies on fetching external packages at runtime. While these features are functionally consistent with a 3D modeling bridge, the inherent RCE capabilities and broad execution permissions represent a high-risk surface.
Capability Assessment
Purpose & Capability
The name/description (Blender MCP bridge) matches the implementation: server.js spawns a local 'uvx blender-mcp' process and proxies JSON-RPC tool calls such as execute_code, get_scene_info, and download/search helpers. There are no unrelated environment variables, credentials, or config paths requested.
Instruction Scope
SKILL.md instructs the agent to use tools that download assets and to run arbitrary BPY (Blender Python) via execute_code. This is expected for a remote-control bridge, but execute_code grants the ability to run arbitrary Python inside Blender (file operations, external requests if allowed by Blender environment). The instructions also expect reading/using local scripts/ and writing .blend files in the working directory — consistent with the skill but worth noting as a privileged action within the Blender environment.
Install Mechanism
There is no install spec (instruction-only), so nothing is downloaded or extracted by the platform. Code files are included in the package, and server.js uses child_process.spawn to launch a local binary. No remote download URLs or archive extraction are present in the install metadata.
Credentials
The skill declares no required environment variables or credentials. The code reads process.env.USERPROFILE (to check for a local uvx.exe path) which is proportional to locating the local helper binary. No secrets or unrelated tokens are requested.
Persistence & Privilege
The skill does not set always:true, does not attempt to modify other skills or agent-wide configs, and only spawns a local helper process. Autonomous invocation remains possible (platform default) but is not combined with elevated persistence or cross-skill access.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install blender-mcp
  3. After installation, invoke the skill by name or use /blender-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
blender-mcp v1.0.0 - Initial release of the advanced MCP bridge for Blender. - Enables real-time querying of the scene, object creation, material application, and custom BPY script execution. - Integrates asset search and import from Sketchfab and PolyHaven. - Includes usage guidelines, sample workflows, and a professional scripts library for standard scene, lighting, and animation tasks. - Designed as an expert tool for optimal, professional Blender workflows and automation.
Metadata
Slug blender-mcp
Version 1.0.0
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 1
Frequently Asked Questions

What is Blender Mcp?

Advanced bridge to Blender via MCP. Allows querying scene, creating objects, applying materials, and running custom BPY code in real-time. It is an AI Agent Skill for Claude Code / OpenClaw, with 626 downloads so far.

How do I install Blender Mcp?

Run "/install blender-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Blender Mcp free?

Yes, Blender Mcp is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Blender Mcp support?

Blender Mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Blender Mcp?

It is built and maintained by FlayZz (@flayzz); the current version is v1.0.0.

💬 Comments