blender-mcp

blender-mcp is an expert-guidance skill for driving Blender through its MCP integration to inspect scenes, script with the Python `bpy` API, export to GLTF/GLB, and extract or debug materials and animations. It solves the practical pain of getting a Blender scene cleanly into a web 3D pipeline (Three.js, React Three Fiber) — where materials, textures, and modifiers silently degrade on export — by encoding the gotchas and the working order of operations.

The skill lays out tool selection (structured MCP tools like `get_scene_info` and `screenshot` for quick inspection, `execute_python` for non-trivial hierarchy traversal and material extraction, and headless CLI for exports that would otherwise time out the MCP server), a health-check-first workflow, and a complete linear export pipeline with ready-to-run Python for extracting the object hierarchy and auditing materials before committing to an export. Bundled references catalogue MCP/GLTF/`bpy` error causes and fixes, a texture-optimization pipeline using gltf-transform (resize, webp, draco applied as discrete steps rather than the destructive `optimize` shortcut), a material-export survival matrix (which Blender features reach GLTF and which must be baked or patched at runtime), GLTF name-mapping quirks, and asset integrations such as PolyHaven, Sketchfab, Hyper3D Rodin, and Hunyuan3D.

It targets 3D artists and web developers moving Blender content to real-time web rendering who hit export losses, oversized GLB files, or missing textures. It is a knowledge-and-workflow skill for legitimate content creation and debugging; the only notable behavior is executing user-directed Python inside Blender and running local Blender/gltf-transform CLI commands as part of a normal asset pipeline.