Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Blender MCP — Puente Streamable-HTTP para Blender 5.2 LTS

Un puente del Model Context Protocol que permite a cualquier cliente MCP (Antigravity, Cursor, Claude Desktop, VS Code 1.101+, MiniMax Code, Windsurf, Continue, Cline, OpenCode, Codex, MCP Inspector, …) controlar Blender 5.2 LTS mediante lenguaje natural.

El complemento ejecuta un servidor MCP Streamable-HTTP dentro de Blender en un hilo en segundo plano. El cliente solo apunta a él: no se genera ningún subproceso, ni hay que cuidar un par de sockets.

Por qué esta forma

  • Una única ruta de instalación dentro de Blender. El servidor MCP se ejecuta en el proceso usando bpy, por lo que no hay baile de uvx/pipx ni un par de sockets que mantener sincronizados.

  • Streamable HTTP en localhost. Funciona con cualquier cliente MCP moderno.

  • Servidor MCP hecho a mano en el complemento. Blender 5.2 LTS incluye Python 3.13 sin paquetes externos por defecto. Un servidor MCP de ~300 líneas es más portátil que arrastrar mcp[cli] y editar sys.path.

  • Independiente del cliente. Sin formato de plugin propietario. Cualquier cliente MCP que pueda alcanzar un endpoint HTTP (o un proxy stdio que lo haga) funciona.

Related MCP server: blender-mcp

Estructura del proyecto

blender_addon_mcp/
├── README.md                      ← you are here
├── LICENSE                        ← MIT
├── pyproject.toml                 ← dev tooling for the add-on (ruff, mypy, pytest)
├── .gitignore
├── addon/
│   └── blender_mcp_addon/         ← zips into a Blender-installable .zip
│       ├── __init__.py            ← bl_info, register/unregister, preferences
│       ├── server/
│       │   ├── __init__.py
│       │   ├── mcp_server.py      ← MCP protocol (initialize, tools/list, tools/call, ping)
│       │   ├── transport.py       ← stdlib http.server, runs on a daemon thread
│       │   └── protocol.py        ← JSON-RPC 2.0 + MCP 2025-03-26 types
│       ├── tools/
│       │   ├── __init__.py        ← tool registry
│       │   ├── scene.py           ← scene_info, frame control
│       │   ├── objects.py         ← list, get, create, delete, transform
│       │   ├── materials.py       ← create, assign, modify
│       │   ├── modifiers.py       ← add, set params, remove
│       │   ├── render.py          ← render_image, screenshot_viewport
│       │   └── code.py            ← execute_python (with confirmation)
│       └── utils/
│           ├── __init__.py
│           ├── bpy_helpers.py     ← bpy → JSON serialization
│           └── safe_eval.py       ← ast-validated code execution
├── scripts/
│   ├── install_addon.ps1          ← zip and install into Blender
│   ├── blender_mcp_proxy.js       ← optional stdio/socket ↔ HTTP bridge for
│   │                                Antigravity builds that don't accept `url`
│   └── start_blender_mcp_bridge.ps1  ← start/stop/status lifecycle for the bridge
├── examples/
│   ├── mcp-configs.md             ← copy-paste configs for every major MCP client
│   ├── basic_scene.md
│   ├── material_setup.md
│   └── render_workflow.md
└── docs/
    ├── architecture.md
    ├── blender_5_2_notes.md
    └── tools_reference.md

Inicio rápido

1. Instalar el complemento

# clone
git clone https://github.com/tattooinmtl/Blender_MCP.git
cd Blender_MCP

# install the add-on into every Blender version on this machine
pwsh ./scripts/install_addon.ps1

2. Habilitar el servidor en Blender

  1. Abre Blender.

  2. Editar → Preferencias → Complementos → busca "Blender MCP" → marca la casilla.

  3. Establece el puerto (por defecto 8765) y haz clic en Iniciar servidor (o usa el panel Blender MCP en la barra lateral de la vista 3D).

  4. La consola debería imprimir:

[Blender MCP] Server listening on http://127.0.0.1:8765/mcp

3. Conecta tu cliente MCP

Elige el cliente que uses y pega el fragmento correspondiente de examples/mcp-configs.md. La forma url de Antigravity es la más sencilla:

{
  "mcpServers": {
    "blender": { "url": "http://127.0.0.1:8765/mcp" }
  }
}

Los fragmentos para Cursor, Claude Desktop, VS Code, MiniMax Code, Windsurf, Continue, Cline y el MCP Inspector están todos en ese archivo.

4. Verificar

En cualquier chat de cliente MCP:

Usa el servidor de blender: ping.

Deberías ver al agente llamar a tools/call en ping y reportar un resultado vacío exitoso. Desde una terminal:

curl -s -X POST http://127.0.0.1:8765/mcp `
  -H "Content-Type: application/json" `
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}'

BlenderMCP Dominator Bundle

Este repositorio también incluye el proyecto completo DomiNations/OpenCivilizations anidado dentro del complemento como blender_mcp_addon/dominator/.

Herramientas adicionales:

Tool

Propósito

dominator_health_check

Verificar complemento, paquete, endpoint MCP, Node/npm, MongoDB, Redis

dominator_setup_scene

Configurar una escena de render de Dominator

dominator_build_unit

Construir una unidad procedural (p. ej. ranged_shooter)

dominator_build_building

Construir un edificio procedural (wall, town_center)

dominator_render_asset

Renderizar la escena a PNG

dominator_list_units

Listar constructores de unidades

dominator_list_buildings

Listar constructores de edificios

dominator_apply_nation_palette

Aplicar una paleta de materiales de nación

Herramientas expuestas

Herramienta

Propósito

Solo lectura

get_addon_info

Handshake de capacidades: nombre, versión, protocolo, lista de herramientas. Llama a esto primero.

sí

scene_info

Resumen de la escena (objetos, luces, cámaras, fotograma)

sí

list_objects

Listar objetos de la escena, con filtro de tipo opcional

sí

get_object

Detalles completos del objeto (ubicación, rotación, escala, modificadores, materiales)

sí

create_object

Crear primitiva (cubo, esfera, plano, cilindro, cono, toro, vacío, cámara, luz)

no

delete_object

Eliminar un objeto por nombre

no

transform_object

Establecer ubicación/rotación/escala

no

set_material

Crear o asignar un material con un Principled BSDF

no

set_texture

Aplicar un archivo de imagen a una entrada de material (base_color, roughness, normal, etc.)

no

import_asset

Importar GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC

no

add_modifier

Añadir un modificador (subdivision, mirror, solidify, array, bevel)

no

remove_modifier

Eliminar un modificador por nombre

no

frame_get / frame_set

Leer / mover la línea de tiempo

mixto

render_image

Renderizar el fotograma actual a un archivo

no

screenshot_viewport

Capturar la vista actual

no

execute_python

Ejecutar código bpy arbitrario (protegido por validación ast)

no

ping

Comprobación de salud

sí

Consulta docs/tools_reference.md para el esquema completo y ejemplos.

Desarrollo

# syntax-check the add-on (Blender's Python is at <blender>/python/bin/python.exe)
python -m py_compile addon/blender_mcp_addon/__init__.py
python -m py_compile addon/blender_mcp_addon/server/mcp_server.py
# ...etc

# lint
ruff check addon/
mypy addon/

# test the MCP server in isolation (no bpy required)
pytest addon/tests/ -v

Licencia

MIT. Consulta LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Blender MCP VXAI

    VxASI
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language control of Blender 3D through MCP clients, allowing creation, modification, and manipulation of 3D models, animations, and scenes.
    300
    MIT

  • blender-mcp

    sandraschi
    A
    license
    C
    quality
    A
    maintenance
    Enables AI-powered control of Blender through natural language, allowing users to create, manipulate, and automate 3D scenes, objects, materials, animations, and more via Claude or other MCP clients.
    71
    62
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    C
    maintenance
    This server enables natural language control of Blender 5.2 LTS through any MCP client, allowing scene inspection, object and material manipulation, rendering, and safe Python execution.
    1
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables any MCP client to drive Blender 5.2 LTS through natural language, with tools for scene inspection, object creation and transformation, material and modifier handling, rendering, viewport capture, and guarded Python execution.
    2
    MIT