home / mcp / blender mcp router

Blender MCP Router

Blessed Server that interfaces common blender functions with LLMs.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mustafa-boorenie-blessed-mcp-server": {
      "url": "http://127.0.0.1:8974/mcp",
      "headers": {
        "XAI_MODEL": "grok-4-fast",
        "XAI_API_KEY": "YOUR_API_KEY",
        "OPENAI_MODEL": "gpt-5",
        "MCP_REST_TOKEN": "YOUR_TOKEN",
        "OPENAI_API_KEY": "YOUR_API_KEY",
        "ANTHROPIC_MODEL": "claude-4",
        "ANTHROPIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You run a Blender-focused MCP server that forwards text generation requests through LiteLLM to various providers and exposes a Blender-ready REST bridge for add-ons. This enables centralized routing, scene inspection tools, and automation workflows between your Blender environment and multiple LLM backends.

How to use

Start the server and connect via an MCP client to access two facilities: (1) unified text generation routed through LiteLLM to providers like OpenAI, xAI, Anthropics, and more, and (2) a Blender bridge that talks to the Blender MCP add-on over a persistent TCP socket for scene info, 3D model helpers, and Hyper3D automation.

How to install

Prerequisites you need before installing:

Python 3.10+
Blender MCP add-on running locally
API keys for any LLM providers you plan to route through LiteLLM

Install the server package in editable mode so you can develop and tweak it locally.

pip install -e .

Configuration and environment

Copy the example environment file and fill in your keys and model preferences.

OPENAI_API_KEY=your-openai-key
XAI_API_KEY=your-xai-key
ANTHROPIC_API_KEY=your-anthropic-key
OPENAI_MODEL=gpt-5
XAI_MODEL=grok-4-fast
ANTHROPIC_MODEL=claude-4
MCP_REST_TOKEN=optional-token

Running

After configuring, start the server with the entry point provided by the package. This launches both the MCP endpoint and the REST bridge for the Blender add-on.

blender-mcp-router

Notes on ports and endpoints

The server exposes two HTTP endpoints locally: the MCP endpoint on 127.0.0.1:8974/mcp and a REST bridge for the Blender add-on on 127.0.0.1:8975. Both services run under the same process and are started from the same runtime entry point.

Available tools

generate_text

Unified text generation routed through LiteLLM to multiple providers via a single MCP tool.

get_scene_info

Blender tool to retrieve current scene information from the Blender MCP add-on.

get_object_info

Blender tool to fetch metadata for objects in the scene.

get_viewport_screenshot

Blender tool to capture and return a viewport screenshot.

execute_blender_code

Execute arbitrary Blender Python code through the MCP bridge.

poly_haven

Helpers for PolyHaven asset lookup via the Blender MCP bridge.

sketchfab

Helpers for Sketchfab asset lookup via the Blender MCP bridge.

hyper3d_automation

Automation helpers for Hyper3D workflows through the MCP bridge.