BlenderMCP - Blender Model Context Protocol Integration

BlenderMCP connects Blender to Claude AI via the Model Context Protocol (MCP), enabling AI-assisted 3D modeling and scene manipulation.

Join the Community

Feedback, inspiration, and collaboration: Discord

Supporters

Top supporters:

CodeRabbit

All supporters:

Support this project

Release notes (1.1.0)

• Added support for Poly Haven assets through their API
• Added support to prompt 3D models using Hyper3D Rodin

Features

• Two-way communication: Socket-based connection between Claude AI and Blender.
• Object manipulation: Creation, modification, and deletion of 3D objects.
• Material control: Application and modification of materials and colors.
• Scene inspection: Detailed scene information retrieval.
• Code execution: Arbitrary Python code execution in Blender from Claude.

Components

1. Blender Addon (addon.py): Creates a socket server within Blender to receive and execute commands.
2. MCP Server (src/blender_mcp/server.py): Implements the Model Context Protocol and connects to the Blender addon.

Installation

Prerequisites

• Blender 3.0+
• Python 3.10+
• uv package manager

Claude for Desktop Integration

Configure claude_desktop_config.json to include the Blender MCP server.

Cursor integration

Configure Cursor's MCP settings to run the Blender MCP server.

Installing the Blender Addon

Install the addon.py file through Blender's Add-ons preferences.

Usage

Starting the Connection

Enable the addon in Blender and connect to Claude.

Using with Claude

Interact with Blender through Claude using the Blender MCP tools.

Capabilities

• Scene and object information retrieval
• Shape manipulation
• Material application
• Python code execution
• Poly Haven asset integration
• Hyper3D Rodin integration

Example Commands

Examples include scene creation, model generation, and object modification.

Hyper3D integration

Utilize Hyper3D's free trial key or obtain your own for model generation.

Troubleshooting

Address connection issues, timeout errors, and Poly Haven integration problems.

Technical Details

Communication Protocol

JSON-based protocol over TCP sockets for commands and responses.

Limitations & Security Considerations

Use the execute_blender_code tool with caution due to potential security risks.

Contributing

Pull Requests are welcome!

Disclaimer

Third-party integration by Siddharth.