BlenderMCP: MCP service that relies on Blender to generate 3D models

General Introduction

BlenderMCP is an open-source tool that provides a comprehensive set of tools through the Model Context Protocol (MCP) protocol connects Blender to the Claude AI connectivity. Users can control Blender directly with text commands to quickly create and edit 3D models, scenes, and materials. This tool is suitable for 3D designers, developers, and enthusiasts, and significantly improves modeling efficiency. It includes a Blender plugin and an MCP server that supports two-way communication, object manipulation, and scene viewing, etc. BlenderMCP is currently available for free on GitHub for anyone to download and use or participate in development.

Function List

• two-way communication: Real-time interaction between Claude AI and Blender via socket server.
• object manipulation: The ability to create, modify or delete 3D objects in Blender.
• Material Adjustment: Supports adding or changing materials and colors for objects.
• Scene View: Get detailed information about the current Blender scene.
• code execution: Run Python code in Blender via Claude.

Using Help

Installation process

BlenderMCP requires two parts to be installed: the Blender plugin and the MCP server. Below are the specific steps:

preliminary

• Software Requirements: Requires Blender 3.0 or above, and Python 3.10 or above.
• Download plug-ins: Visit the GitHub page to download addon.py Documentation.

Installing the Blender plug-in

1. Open Blender and click on the Edit > Preferences > PluginsThe
2. strike (on the keyboard) mounting button, select the downloaded addon.py Documentation.
3. Once the installation is complete, find the plugin list in the Interface: Blender MCP, check Enable.

Starting the MCP server

1. Open a terminal and enter the command to start the server:

uvx blender-mcp

2. If you're on a Mac, install the uv tools first:

brew install uv

3. For Windows or other system users, see uv official website Get the installation method.

Configuring Claude Desktop Edition (optional)

If you are using the desktop version of Claude, you can have it automatically run BlenderMCP as follows:

1. Find the configuration file path:

• macOS. ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows. %APPDATA%/Claude/claude_desktop_config.json

2. Edit the file to add the following:

{
"mcpServers": {
"blender": {
"command": "uvx".
"args": ["blender-mcp"]
}
}
}

3. Once saved, Claude will automatically start the MCP server when needed.

activate a connection

1. In Blender, press N key opens the 3D view sidebar.
2. locate BlenderMCP Tab.
3. Set the port number, the default is 9876(Generally no change is necessary).
4. strike (on the keyboard) Start MCP Server Start the server within the plugin.
5. Verify that the MCP server is also running in the terminal (i.e., it executes the uvx blender-mcp).

How to use the main features

Once the connection is successful, you can operate Blender by entering text commands through Claude AI.Here is how to use it:

View Scene Information

• directives: Enter "Get information about the current scene".
• effect: Claude call get_scene_info tool, which returns information about the number and position of objects in the scene.
• procedure: Enter a command in the Claude interface, wait a few seconds, and then view the returned result.

Creating Simple Objects

• directives: Type "Create a sphere and place it above the cube".
• effect: By create_primitiveIf you have a cube, Blender generates a sphere and places it on top of the cube.
• procedure: After entering the commands, Claude will automatically complete the creation and you can see the result in Blender.

Adjusting the object material

• directives: Type "Make this car red and metallic".
• effect: Use set_material cap (a poem) modify_object, changed the material of the car to red metallic.
• procedure: Make sure there are car objects in the scene, and check for material changes after entering the command.

Deleting objects

• directives: Enter "Delete the cube".
• effect: Call delete_object, removes the cube from the scene.
• procedure: After entering the command, go back to Blender to confirm that the cube has disappeared.

Running Python Code

• directives: Type "Run this code in Blender: bpy.ops.mesh.primitive_uv_sphere_add(radius=2, location=(0,0,5))".
• effect: By execute_blender_codeIn Blender, create a sphere with radius 2 and position (0,0,5).
• procedure: Enter the full command and Claude will send the code to Blender for execution. Note: Save the file before running in case of errors.

Creating Complex Scenes

• directives: Type "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold".
• effect: Claude invokes several tools step-by-step to generate low polygon dungeons, dragons, and pots of gold scenes.
• procedure: Wait a few moments after entering the command and Blender will display the complete scene. Refer to .

workflow

1. Starting services: Press the "Start Connection" step to ensure that both the Blender plugin and the MCP server are running.
2. input: Enter the actions you want to perform in the Claude interface, such as creating objects or adjusting lighting.
3. Confirmation of results: Go back to Blender and see if the scene is updating as instructed.
4. sort: If it doesn't respond, open Blender's console (Window > Toggle Console) and check the error message.

caveat

• Streamlining of mandates: Complex instructions may need to be broken down into smaller steps, such as creating the object first and then modifying the attributes.
• Security tips: Use execute_blender_code Be careful when running unknown code to avoid crashing the program.
• connection failure: If you can't connect, check that the port number is the same and that the firewall is not blocking it.

With these actions, you can quickly build 3D models and scenes in Blender with simple text commands that save you time and convenience!

One sentence description (brief)

BlenderMCP is an open source tool that connects Blender and Claude AI through the Model Context Protocol, allowing users to create and modify 3D models, scenes, and materials in Blender with text commands that support object manipulation, material adjustment, and Python code execution, making it suitable for generating high-quality 3D content quickly.