BlenderMCP – A 3D Modeling Tool Integrated with MCP

What is BlenderMCP?

BlenderMCP is a tool that integrates Blender with Claude AI based on the Model Context Protocol (MCP). BlenderMCP uses a socket server to enable bidirectional communication between Blender and AI, supporting features such as creating, modifying, and deleting 3D objects, controlling materials and colors, retrieving scene information, and running Python code within Blender. Users can leverage Claude’s natural language instructions to quickly complete complex 3D modeling and scene operations, significantly improving creation efficiency. The tool consists of a Blender plugin and a Python server, and after installation, seamless integration can be achieved with a simple configuration.

The main functions of BlenderMCP

• Object Operations: Supports the creation, modification, and deletion of 3D objects, including basic geometries and complex models.
• Material and Color Control: Applies and modifies materials, and adjusts the color and texture of objects.
• Scene Information Retrieval: Retrieves detailed information about the current Blender scene, including object lists, properties, etc.
• Code Execution: Supports running arbitrary Python code within Blender to enable more advanced operations.
• Scene Creation and Adjustment: Quickly generates or adjusts 3D scenes based on natural language instructions, such as creating scenes of specific styles or adjusting lighting and camera positions.

The Technical Principles of BlenderMCP

• Blender Addon (addon.py): A plugin that runs internally within Blender, responsible for creating a socket server. It receives commands from external sources, executes those commands in Blender, such as creating objects, modifying materials, etc. The plugin is also responsible for feeding Blender’s scene information or operation results back to the external server.
• MCP Server (server.py): An independent Python server that implements the Model Context Protocol (MCP). It communicates with the Blender plugin via TCP sockets, receives instructions issued by users based on Claude AI, and converts them into commands that Blender can understand. The server processes the results returned by Blender and feeds them back to Claude AI.
• Communication Protocol: Communication is based on a JSON-based protocol. Commands are sent in the form of JSON objects, containing a `type` and optional `params`. Responses are also JSON objects, containing `status` and either `result` or `message`, providing feedback on the operation results or error information.

The project address of BlenderMCP

• GitHub Repository: https://github.com/ahujasid/blender-mcp

Application scenarios of BlenderMCP

• Rapid Modeling: Quickly create 3D models and scenes based on natural language instructions.
• Material and Color Adjustment: Modify the material and color effects of models through language commands.
• Scene Optimization: Adjust lighting, camera positions, and layouts to optimize scene effects.
• Animation and Dynamic Effects: Generate or adjust animations to achieve dynamic scene design.
• Education and Assisted Creation: Reduce the learning difficulty of 3D modeling and assist beginners and educational scenarios.