AB
AiBoss
project

BlenderMCP - A 3D modeling tool based on MCP integration

BlenderMCP is a tool that integrates Blender and Claude AI based on the Model Context Protocol (MCP). BlenderMCP uses a socket server to enable bidirectional communication between Blender and the AI, supporting the creation, modification, and deletion of 3D objects...

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 the AI, supporting functions such as creating, modifying, and deleting 3D objects, controlling materials and colors, obtaining scene information, and running Python code within Blender. Users can quickly complete complex 3D modeling and scene operations based on Claude's natural language commands, greatly improving creative efficiency. The tool consists of a Blender plugin and a Python server, achieving seamless connection after installation with simple configuration.

Main functions of BlenderMCP

  • Object operationsSupports the creation, modification, and deletion of 3D objects, including basic geometry and complex models.
  • Material and color controlApply and modify materials to adjust the color and texture of objects.
  • Scene information acquisition: Retrieves detailed information about the current Blender scene, including a list of objects, properties, etc.
  • Code executionIt supports running arbitrary Python code in Blender, enabling more advanced operations.
  • Scene creation and adjustmentBased on natural language instructions, quickly generate or adjust 3D scenes, such as creating scenes with a specific style or adjusting the position of lights and cameras.

Technical principles of BlenderMCP

  • Blender plugin (addon.py)This is a plugin that runs within Blender and is responsible for creating a socket server. It receives commands from the outside and executes them within Blender, such as creating objects or modifying materials. The plugin is also responsible for feeding back Blender scene information or operation results to the external server.
  • MCP server (server.py)A standalone Python server that implements the Model Context Protocol (MCP). It communicates with Blender plugins via TCP sockets, receiving user commands issued by Claude AI and translating them into commands that Blender can understand. The server processes the results returned by Blender and feeds them back to Claude AI.
  • Communication ProtocolCommunication is based on a JSON protocol. Commands are sent as JSON objects, including type and optional params. Responses are also JSON objects, containing status and result or message, indicating the operation result or error information.

BlenderMCP project address

Application scenarios of BlenderMCP

  • Rapid modelingQuickly create 3D models and scenes based on natural language instructions.
  • Material and color adjustmentModify the material and color effects of the model based on language commands.
  • Scene optimizationAdjust lighting, camera position and layout to optimize scene effects.
  • Animation and Dynamic EffectsGenerate or adjust animations to achieve dynamic scene design.
  • Education and Creative Support: Reduce the learning difficulty of 3D modeling and assist beginners and educational scenarios.