blender-mcp

Minimal bridge to run Python in a live Blender session from an MCP server. By exposing a single tool call, this MCP allows LLMs to do what they do best: write code.

What this repo contains

• blender_mcp_runner.py: Blender add-on that opens a local TCP endpoint (127.0.0.1:8765) and executes queued scripts on Blender's main thread.
• server.py: MCP server exposing run_blender_python, which forwards scripts to the Blender add-on.

Prerequisites

• Python 3.10+
• Blender 3.0+

Installation

1. Clone this repo and enter it:

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

2. Create and activate a virtual environment:

   python -m venv .venv
   .\.venv\Scripts\Activate.ps1

3. Install Python dependency:

   pip install mcp

4. Install the Blender add-on:
   • Blender -> Edit -> Preferences -> Add-ons -> Install...
   • Select blender_mcp_runner.py, enable MCP Python Runner (TCP).

Run

1. Start Blender with the add-on enabled.
2. Add server.py to your preferred applications MCP configuration file.