Blender MCP Server

Model Context Protocol (MCP) server for complete Blender control via API

This addon transforms Blender into an MCP server, exposing 50+ powerful tools that can be orchestrated by AI agents through HTTP endpoints. Perfect for AI-driven 3D workflows, automation, and creative experimentation.

✨ Features

• 🚀 50+ Tools - Complete control over Blender’s features:

  • Object creation, manipulation, and transformation
  • Material and shader system management
  • Animation and keyframe control
  • Camera and lighting setup
  • Modifiers and constraints
  • Physics simulations (rigid body, cloth, fluid)
  • Geometry nodes and procedural generation
  • File import/export operations
  • Scene optimization and batch operations

• 🔒 Thread-Safe Execution - Enterprise-grade queue system for safe concurrent operations

• 📦 Auto-Install Dependencies - Automatically installs required packages on first run

• 🎮 Simple UI Panel - Start/stop server with one click from Blender’s N-panel

• 📊 Real-time Monitoring - Track operations, statistics, and server status

• 🔧 Production-Ready - Comprehensive error handling, logging, and caching

🚀 Quick Start

Installation

1. Download blender_mcp.py
2. Open Blender
3. Go to Edit → Preferences → Add-ons
4. Click the dropdown arrow (⌄) next to the search bar
5. Select Install from Disk…
6. Choose the downloaded blender_mcp.py file
7. Enable the addon by checking the box next to “MCP Complete Server for Blender”

Starting the Server

1. Press N in the 3D Viewport to open the sidebar
2. Navigate to the MCP Server tab
3. Click Start Server
4. Server will start on http://localhost:8000

The addon will automatically install required dependencies on first run (FastAPI, Uvicorn, Pydantic, etc.).

🤖 Using with PolyMCP

This MCP server is designed to work seamlessly with PolyMCP - a powerful framework for orchestrating MCP servers with AI agents.

Example: AI-Controlled Blender

#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider

async def main():
    # Initialize your LLM provider
    llm = OllamaProvider(model="gpt-oss:120b-cloud", temperature=0.1)
    
    # Connect to Blender MCP server
    agent = UnifiedPolyAgent(
        llm_provider=llm, 
        mcp_servers=["http://localhost:8000/mcp"],  
        verbose=True
    )
    
    async with agent:
        print("✅ Blender MCP Server connected!\n")
        
        # Chat with your AI to control Blender
        while True:
            user_input = input("\n🎨 You: ")
            
            if user_input.lower() in ['exit', 'quit']:
                break
            
            result = await agent.run_async(user_input, max_steps=5)
            print(f"\n🤖 Blender: {result}")

if __name__ == "__main__":
    asyncio.run(main())

Example Commands