MCP 服务器

blender-mcp

Enables AI-powered control of Blender through natural language, allowing users to create, manipulate, and automate 3D scenes, objects, materials, animations, and more via Claude or other MCP clients.

README

Blender MCP — AI-Powered Blender Automation

Control Blender with natural language through MCP. Tell Claude "create a steampunk robot with glowing red eyes" and watch it build your vision in Blender automatically.

Quick Start

git clone https://github.com/sandraschi/blender-mcp
cd blender-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup (without `just`)

uv sync
.venv\Scripts\activate
python run_server.py

Claude Desktop Integration

Add to your claude_desktop_config.json:

"mcpServers": {
  "blender-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/blender-mcp", "run", "blender-mcp"]
  }
}

Webapp Dashboard

A premium web interface for monitoring and control runs on port 10848 (backed by API on 10849).

.\start.ps1

Startup flags: -Headless (background), -BackendOnly (API only), -NoBrowser (no auto-open).

Access the dashboard at http://localhost:10848.

Available Tools (41+ tools, 170+ operations)

Category	Tools
Scene Management	create/clear/list scenes, collections, view layers
Mesh & Geometry	cube, sphere, cylinder, plane, torus, monkey, text, curves, NURBS
Materials & Shaders	metal, wood, glass, fabric, ceramic, plastic, emissive, presets
Furniture	chair, table, bed, sofa, room, building
Lighting	sun, point, spot, area lights, HDRI environments, lighting rigs
Camera & Viewport	camera creation, positioning, rigs, viewport config
Animation & Rigging	armatures, character rigging, keyframes, walk cycles
Rendering & Output	Cycles/EEVEE, render settings, animation rendering, render passes
Import & Export	FBX, OBJ, glTF, STL, batch export
Physics & Simulation	rigid/soft body, cloth, fluid, particle systems
Modifiers & Effects	subdivision, bevel, array, boolean, lattice
Textures & UVs	procedural textures, image textures, UV unwrap, texture baking
Video Editing (VSE)	20 operations: add clips, transitions, text, audio, render to MP4

Key capabilities:

Conversational 3D Creation: Natural language to professional 3D objects
FastMCP 3.2 Integration: Advanced AI sampling and security validation
Object Repository: Versioned asset management with intelligent search
Cross-Platform Export: Handoff to VR platforms (VRChat, Resonite, Unity)
VRM Avatars: Avatar pipeline for VR/AR applications
3D Gaussian Splatting: Import and render splats
Grease Pencil: 2D drawing in 3D space

Documentation

Installation Guide — full setup and troubleshooting
Addons, Mesh, Splat — install addons from URL, search packs, download/import meshes, Gaussian splat import; webapp /mesh page
Video Editing (VSE) — Blender's built-in video editor: add clips, transitions, text, audio; render to MP4
Development — Ruff (lint/format), code quality, server entry points
Usage Examples — AI construction examples, VR avatar pipeline, batch processing
Features Overview — complete tool catalog, AI construction details, VR platform integration
Architecture — system design, security, performance, scalability
Troubleshooting — common issues, debug info, platform-specific problems

Native Desktop App (Tauri 2.0)

A ~15 MB installer bundles the full app — no Python, no Node.js, no git clone needed.

just build-native        # Full pipeline: webapp → PyInstaller → Tauri installer
just build-native-debug  # Debug build (skips PyInstaller)

The installer lands at native/target/release/bundle/nsis/Blender MCP_0.1.0_x64-setup.exe.

Industrial Quality Stack

Adheres to SOTA 14.1 industrial standards:

Python: Ruff for linting and formatting. Zero-tolerance for print in core handlers (T201).
Webapp: Biome for sub-millisecond linting. Strict noConsoleLog enforcement.
Protocol Compliance: Hardened stdout/stderr isolation for crash-resistant JSON-RPC communication.
Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).
Security: Automated audits via bandit and safety.

Packaging & Distribution

SOTA 2026 compliant via @anthropic-ai/mcpb:

mcpb pack . dist/blender-mcp.mcpb

Architecture

src/blender_mcp/server.py — Core FastMCP 3.2 server definition
src/blender_mcp/handlers/ — Context-specific tool handlers (scene, object, render, etc.)
src/blender_mcp/tools/ — MCP tool definitions organized by category
src/blender_mcp/utils/ — Path resolution and Blender integration utilities
webapp/ — React dashboard for fleet visibility

Development

uv run pytest                    # Run tests
uv run ruff check .              # Lint
uv run ruff format .             # Format
uv run mypy src                  # Type check