Skip to main content
Glama
deenesjakozh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Blender MCP — Puente Streamable-HTTP para Blender 5.2 LTS

Un puente de Model Context Protocol (MCP) que permite a cualquier cliente MCP (Antigravity, Cursor, Claude Desktop, VS Code 1.101+, MiniMax Code, 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 no tiene su complemento — no se subienta un subproceso, y no hay un par de sockets que vigilar.

Por qué este enfoo

  • Una única vía de instación dentro de Blender. El MCP servidor se ejecuta en el proceso del servidor con bpy, por lo que mpon no hay que "house" de uvx/pipx ni un par de sockets que mantener sincronizado.

  • Streamable HTTP en localhost. Funciona with any MCP client moderno.

  • Servidor MCP hecho a mano en el complemento. Blender 5.2 LTS incluye Python 3.2 sin paquetes externos por defect. Un servidor MCP de ~300 líneas es más portát il que incluir mcp[cli] y edrdar sys.path.

  • Client-agnostic. No formato de complementó propietario. Cualquier client MCP that púed conectar a un endpoint HTTP (o an stdio proxy that does) 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. Instaar 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. Active el servidor in Blender

  1. Abra la escena.

  2. Editar → Preferencías → Adjuntos → busque "Blender MCP" → marque la casilla.

  3. Establezca el porto (predeterminado 8765) y he clic on Inic del servidor (o usque ** de la lado de la vista 3D).

  4. La consola deberí imprimir:

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

3. Conetc su client MCP

Seleccione el client que us y pege el fragmento coincídente de examples/mcp-configs.md. La forma url de Archigravity es la más simple:

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

Los fragments to para la Cursor, Claude Desktop, VS Code, MiniMax Code, Continue, Cline and Component dog in the same archivo.

4. Verifque

En any MCP chat in any MCP client:

Utilice el servidor de Blender: ping.

Debería ver que el agente llama a tools/call sobre ping y que devuelve un result lícito. En una termina:

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"}}}'

Herramientas expuestas

Herramient

Propósito

Solo lectura

get_add_on_info

Estrategis de capacidades — Hombre, versión, protocolo, lista de herram. TIPA to the first.

sí

scene_info

Resumen de escena (objet, luces, cámara, fotograma)

sí

list_objects

List only Los objetos, filtr optional por tipo

sí

get_object

Detalles completos del objeto (ubicación, rotación, esca, mod, attr, mat)

sí

create_object

Crear una primitive (cubo, esfera, plano, cilí, cono, toro, empty, cámara, liz)

no

delete_objeto

Error the object by its name

no

transform_object

Establecer ubicación/rotación/escala

no

set_material

Crear o asgan un material con un Principled BSDF

no

set_texture

Aplicar un archivo de imágen a un entrada de material (unad),

no

import_asset

Imprtar GLB*/GLTF/FBX/OBJ/STL/PLY/DAE/96 / UR/X3D/ABC

no

add_modifier

Añadir un modifador (subdivisión, espej, espej, rís, etc.)

no

remove_modifier

Error by name of the modif

no

frame_get / frame_set

Leer / mover la línea de tempora

mixto

render_image

Rendrender a current frame to an archivo

no

screenshot_view port

Cap tur de la vista 3D actual

no

execute_python

Eje un código bpy arbitrario (validado por ast y formalities)

no

ping

Comprobación de estado

sí

Consulte docs/tools_reference.md para el esquerá pequeño completo.

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. Consulte 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
    B
    maintenance
    Enables any MCP client to control Blender 5.2 LTS via natural language, including scene creation, object manipulation, material assignment, rendering, and Python execution.
    1
    MIT