ooMike1/BlenderMCP

3.2

If you are the rightful owner of BlenderMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

BlenderMCP is a Model Context Protocol server designed for controlling Blender 3D operations through natural language commands.

BlenderMCP

Model Context Protocol server for Blender 3D operations.

Overview

BlenderMCP enables programmatic control of Blender through MCP, allowing creation and manipulation of 3D objects via natural language commands.

Installation

Clone repository:

git clone https://github.com/ooMike1/BlenderMCP.git
cd BlenderMCP

Install dependencies:

pip install -r requirements.txt

Configure your MCP client (see mcp_config_example.json):

{
  "mcpServers": {
    "blender": {
      "command": "python",
      "args": ["path/to/BlenderMCP/main.py"]
    }
  }
}

Requirements

Python 3.8+
Blender 3.6+
MCP-compatible client

Features

Basic Tools

Object Creation: Cubes, spheres, cylinders, planes, cones
Scene Management: Clear scene, save files, export models
Formats: OBJ, FBX, STL, PLY export support

Advanced Tools

Boolean Operations: Union, difference, intersection
Modifiers: Array, bevel, solidify, subdivision surface
Materials: Basic material application
Mesh Operations: Subdivide and smooth meshes

Usage

Start server:

python main.py

Example commands:

"Create a 2x2x2 cube at origin"
"Apply boolean union to cube and sphere"
"Export scene as model.obj"
"Add array modifier with 5 copies"

Configuration

See setup_instructions.md for detailed setup guide.

Files

main.py - Entry point
server.py - Core MCP server
blender_integration.py - Blender API interface
advanced_tools.py - Extended functionality
boolean_operations.py - Boolean operations
modifiers.py - Modifier tools
materials.py - Material handling

Troubleshooting

Blender not found: Ensure Blender is in PATH or at:

Windows: C:\Program Files\Blender Foundation\Blender\
macOS: /Applications/Blender.app
Linux: /usr/bin/blender

License

See LICENSE file for details.