Blender Mcp

What it does

This skill, Blender MCP, provides tools and guidance for AI agents interacting with Blender through the Model Context Protocol (MCP). It enables agents to inspect a Blender scene, extract its hierarchy and material information, and perform non-trivial operations using Python scripting within Blender's environment. Specifically, it facilitates automated workflows like GLTF exports by leveraging the bpy API and handling potential timeout issues associated with lengthy export processes.

When to use it

• Automated Scene Inspection: Quickly assess a Blender scene’s structure and content before performing modifications or exporting.
• GLTF Export Workflows: Handle complex GLTF export operations that might time out using standard MCP tools.
• Material Verification: Identify missing or problematic materials within a Blender scene to ensure correct exports.
• Scene Hierarchy Traversal: Extract and analyze the entire object hierarchy of a Blender scene for reporting or further processing.

Key capabilities

• Structured Tool Selection: Provides pre-defined MCP tools like get_scene_info (for connection verification) and screenshot (for viewport capture).
• Python Scripting via execute_python: Allows running arbitrary Python code within Blender, granting full access to the bpy API.
• Headless CLI for GLTF Exports: Facilitates GLTF exports using a command-line interface to avoid MCP timeout issues.
• Scene Hierarchy Extraction: Extracts detailed information about objects including name, type, location, rotation, scale, visibility, vertex count and material assignments.

Example prompts

• "Run get_scene_info to check the Blender connection."
• "Execute Python: print("ok") to verify Python execution within Blender."
• "Use execute_python to extract the scene hierarchy and print it as JSON."

Tips & gotchas

• Health Check First: Always start with a health check (using get_scene_info, execute_python: print("ok"), and screenshot) to ensure MCP connectivity before attempting any other operations.
• Python for Complexity: For anything beyond simple inspection, leverage the execute_python tool to access Blender’s full API.
• GLTF Exports Timeout: Use the headless CLI method for GLTF exports as standard MCP calls may time out during these lengthy processes.