What is Blender Mcp

Blender MCP is a Model Context Protocol (MCP) server designed for managing and executing Blender scripts efficiently.

Use cases

Use cases include automating repetitive tasks in Blender, executing complex scripts for scene analysis, and managing multiple scripts for various projects.

How to use

To use Blender MCP, start the server by running ‘python server.py’, then connect to it using an MCP client. You can manage scripts with functions like add_script, edit_script, execute_script, and remove_script.

Key features

Key features include the ability to add, edit, execute, and remove Blender Python scripts, execute scripts in a headless Blender environment, view execution results and errors, and track script metadata such as creation date and execution count.

Where to use

Blender MCP can be used in fields such as animation, game development, and architectural visualization, where automation of Blender scripting is beneficial.

Blender MCP Server

A Model Context Protocol (MCP) server for managing and executing Blender scripts.

Features

• Add, edit, execute, and remove Blender Python scripts
• Execute scripts in a headless Blender environment
• View execution results and errors
• Track script metadata (creation date, last modified, execution count)

Requirements

• Python 3.7+
• Blender installed and accessible
• MCP library (pip install mcp)

Usage

1. Start the server:

   python server.py
   

2. Connect to the server using an MCP client (like Claude Desktop)

3. Use the provided tools to manage scripts:

   • add_script(name, content) - Add a new script
   • edit_script(name, content) - Edit an existing script
   • execute_script(name, blend_file=None) - Execute a script in Blender, optionally specifying a .blend file
   • remove_script(name) - Remove a script

4. Access resources to get information:

   • scripts://list - Get list of available scripts
   • script://{name} - Get content of a specific script
   • result://{name} - Get execution result of a script

Examples

Basic Example

# Add a simple script
add_script("hello_cube", '''
import bpy

# Clear existing objects
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()

# Create a cube
bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))
print("Cube created!")
''')

# Execute the script
execute_script("hello_cube")

# Get the result
# Access using: result://hello_cube

Working with Blend Files

# Add a script that works with a blend file
add_script("analyze_scene", '''
import bpy

# Print information about the current scene
print(f"Current Blender version: {bpy.app.version_string}")
print(f"Current file: {bpy.data.filepath}")

# List all objects in the scene
print("\\nObjects in the scene:")
for obj in bpy.data.objects:
    print(f" - {obj.name} ({obj.type})")
''')

# Execute with a specific blend file
execute_script("analyze_scene", blend_file="/path/to/your/project.blend")

# Get the result
# Access using: result://analyze_scene

How It Works

1. When a script is added, it’s stored in the script_files/scripts directory
2. When executed, the script is run in a headless Blender instance
   • If a blend file is specified, Blender will open that file before running the script
   • Otherwise, a default empty Blender scene is used
3. Output and errors are captured and stored in the script_files/results directory
4. Metadata about scripts is tracked in script_files/metadata.json

Installation

1. Clone this repository
2. Install the MCP library: pip install mcp
3. Ensure Blender is installed and accessible from your PATH

License

MIT