How ahujasid/mcp-for-blender works
MCP for Blender connects an AI client to Blender through an MCP server and a Blender-hosted socket addon. The main workflow is a client tool request, server-side tool handling, socket command execution in Blender, and a result returned to the client. Documented capabilities include scene/object/material manipulation, inspection, code execution, and external asset/model generation. Setup, consent and privacy telemetry, app extensions, and trajectory capture are supporting runtime branches. Several feature-specific server internals are unsampled, so capability details rely on the README rather than inferred call chains.
Main entry points: server.py MCP Server Tools · telemetry_decorator.py Tool Instrumentation · telemetry.py Usage Telemetry · addon.py Blender Addon
Components 21
MCP Connection
- MCP Server Tools
src/blender_mcp/server.py - Blender Socket
src/blender_mcp/server.py
Blender Operations
- Blender Addon
addon.py - Scene and Objects
src/blender_mcp/server.py - Materials and Colors
src/blender_mcp/server.py - Scene Inspection
src/blender_mcp/server.py - Code Execution
src/blender_mcp/server.py - Safe Mode Validator
src/blender_mcp/safe_mode.py
Creative Features
- Asset Search
src/blender_mcp/server.py - Model Generation
src/blender_mcp/server.py - Client App Extensions
src/blender_mcp/openai_apps.py - Asset and Model Services
Setup and Guidance
- Setup CLI
src/blender_mcp/setup_cli.py - Addon Installer
src/blender_mcp/addon_manager.py - Premium Guidance
src/blender_mcp/premium_hint.py
Privacy and Capture
- Telemetry Consent
src/blender_mcp/consent_prompt.py - Usage Telemetry
src/blender_mcp/telemetry.py - Tool Instrumentation
src/blender_mcp/telemetry_decorator.py - Trajectory Capture
src/blender_mcp/trajectory.py - Supabase
Other components
- AI Client
Connections 25
- AI Client → MCP Server Tools: requests tools
README.md - MCP Server Tools → Blender Socket: sends commands
src/blender_mcp/server.py - Blender Socket → Blender Addon: socket commands
README.md - Blender Addon → AI Client: returns results
README.md - MCP Server Tools → Scene and Objects: provides tools
README.md - MCP Server Tools → Materials and Colors: provides tools
README.md - MCP Server Tools → Scene Inspection: provides tools
README.md - MCP Server Tools → Code Execution: provides tools
README.md - MCP Server Tools → Safe Mode Validator: validates code
src/blender_mcp/safe_mode.py - MCP Server Tools → Asset Search: provides tools
README.md - MCP Server Tools → Model Generation: provides tools
README.md - Asset Search → Asset and Model Services: searches assets
README.md - Model Generation → Asset and Model Services: requests models
README.md - MCP Server Tools → Client App Extensions: uses extensions
src/blender_mcp/server.py - Setup CLI → Addon Installer: installs addon
src/blender_mcp/setup_cli.py - MCP Server Tools → Addon Installer: checks handshake
src/blender_mcp/server.py - MCP Server Tools → Premium Guidance: adds guidance
src/blender_mcp/server.py - MCP Server Tools → Telemetry Consent: requests consent
src/blender_mcp/server.py - Telemetry Consent → Blender Socket: writes consent
src/blender_mcp/consent_prompt.py - Tool Instrumentation → MCP Server Tools: wraps tools
src/blender_mcp/server.py - Tool Instrumentation → Usage Telemetry: records events
src/blender_mcp/telemetry_decorator.py - Tool Instrumentation → Trajectory Capture: records steps
src/blender_mcp/telemetry_decorator.py - Usage Telemetry → Blender Socket: checks consent
src/blender_mcp/telemetry.py - Usage Telemetry → Supabase: sends events
src/blender_mcp/telemetry.py - Trajectory Capture → Supabase: persists captures
src/blender_mcp/trajectory.py