Blender MCP Tutorial Center

Step 1: Clone the Blender MCP Repository

First, you need to clone the Blender MCP repository from GitHub to your local computer. Open a terminal or command prompt and run the following commands:

git clone https://github.com/ahujasid/blender-mcp.git
cd blender-mcp

Step 2: Install Dependencies

Make sure you have Python 3.9+ installed, then install all the dependencies required for Blender MCP:

pip install -r requirements.txt

If you're using a virtual environment, make sure to activate it before running the above command.

Step 3: Configure the MCP Server

In the config.py file, you need to configure your API key:

# Modify the config.py file
API_KEY = "Your OpenRouter or Claude API Key"
API_BASE = "https://openrouter.ai/api/v1"  # If using OpenRouter
# Or
API_BASE = "https://api.anthropic.com/v1"  # If using Claude directly

Step 4: Start the MCP Server

Run the following command to start the MCP server:

python server.py

The server will start and listen on the default port. You should see output similar to the following:

INFO:     Started server process [12345]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

Step 5: Install the MCP Plugin in Blender

Open Blender, then go to Edit > Preferences > Add-ons > Install

Find and select the blender-mcp/addon/mcp_addon.py file

Activate the plugin by ensuring the checkbox is checked

In the plugin settings, ensure the API endpoint URL matches your running server (default is http://localhost:8000)

Step 6: Test the Installation

In Blender, press N to open the properties panel

You should see a "Blender MCP" tab

Click on that tab, and in the input box, type: "Create a red cube"

Click the "Send" button to verify that the plugin is working correctly

Troubleshooting

• Connection Errors: Ensure the MCP server is running and check the API endpoint settings in the plugin
• API Key Errors: Verify that the API key you entered in config.py is correct
• Plugin Not Showing: Check if the plugin is properly installed and activated