blender-MCP
Provides tools for preparing video game characters inside Blender, including importing assets, validating and normalizing characters, renaming animation actions, and exporting to GLB.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blender-MCP Validate the character and list its animations"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Berrio Blender MCP
Servidor MCP y complemento de Blender para preparar personajes de videojuegos de forma segura, repetible y verificable.
El proyecto se concentra en operaciones de alto nivel. No expone una herramienta para ejecutar Python arbitrario dentro de Blender.
Estado
Versión 0.3.0 (alpha). La API del puente usa el contrato versionado 1.0.
Related MCP server: blendermcp
Arquitectura
Cliente MCP (Codex, inspector, IDE)
│ stdio / Streamable HTTP local
▼
Servidor Python FastMCP
├─ política de rutas
├─ dry-run por defecto
└─ herramientas estructuradas
│ JSONL + token, 127.0.0.1:9876
▼
Complemento de Blender
├─ cola hacia el hilo principal
├─ operaciones permitidas
└─ checkpoints de archivos .blendHerramientas MCP
Herramienta | Función |
| Comprueba conexión, versiones y capacidades |
| Resume escena, armaduras, mallas y acciones |
| Lista objetos sin modificar la escena |
| Valida rig, clips, límites, materiales y dimensiones |
| Genera un Forjador del Éter original, riggeado y animado, compacto o semirrealista |
| Importa FBX, GLB, GLTF u OBJ |
| Normaliza altura, centro y contacto con el suelo |
| Convierte nombres de clips a un contrato estable |
| Exporta armadura, mallas y animaciones a GLB |
Las operaciones que cambian archivos o escenas usan dry_run=true de manera predeterminada.
Requisitos
Python 3.11 o posterior.
uvpara un entorno reproducible.Blender 4.2 o posterior para el complemento.
Preparar el servidor
uv sync --extra dev
uv run pytest
uv run python scripts/build_addon.pyEl último comando genera dist/blender_mcp_bridge-0.3.0.zip.
Arquetipos originales
Arquetipo | Uso recomendado | Complejidad aproximada |
| Fallback compacto y prototipos | 18 huesos, 12.396 triángulos, 8 materiales |
| Héroe semirrealista para el juego | 39 huesos, 40.522 triángulos evaluados, 12 materiales |
V2 añade proporciones humanas mejoradas, dedos, rasgos faciales, cabello por mechones, ropa dividida, armadura laminada, huesos de torsión y abrigo, y microdetalle procedural en los materiales. Sigue siendo un activo semirrealista optimizado para juego; no sustituye un flujo de escultura y texturizado humano fotorrealista.
Para instalar una copia portátil verificada de Blender 4.5 LTS dentro de .tools:
powershell -ExecutionPolicy Bypass -File scripts\install_blender_portable.ps1El script descarga desde download.blender.org, compara la suma SHA-256 oficial y solo después extrae el programa. .tools está excluido de Git.
Instalar el complemento
En Blender, abre Edit → Preferences → Add-ons.
Selecciona Install from Disk e instala el ZIP generado.
Activa Berrio Blender MCP Bridge.
Opcionalmente configura un token en las preferencias.
Abre 3D View → Sidebar → Blender MCP y pulsa Start MCP Bridge.
El puente solo acepta conexiones de loopback. Si se configura un token, el servidor MCP debe recibir el mismo valor en BLENDER_MCP_TOKEN.
Ejecutar mediante stdio
uv run blender-mcpConfiguración MCP genérica:
{
"mcpServers": {
"blender-character-pipeline": {
"command": "uv",
"args": [
"--directory",
"C:\\ruta\\a\\blender-MCP",
"run",
"blender-mcp"
],
"env": {
"BLENDER_MCP_WORKSPACE_ROOTS": "C:\\ruta\\a\\Repos",
"BLENDER_MCP_TOKEN": "el-mismo-token-de-blender"
}
}
}
}También puede ejecutarse mediante Streamable HTTP restringido al equipo local:
uv run blender-mcp --transport streamable-http --host 127.0.0.1 --port 8000Skill de personajes para Codex
La skill versionada en skills/blender-character-pipeline enseña a Codex a diagnosticar por capas, ejecutar cambios primero como simulación y distinguir problemas del activo Blender de fallos de animación, navegación o control dentro del motor.
Instálala en el perfil actual de Codex:
powershell -ExecutionPolicy Bypass -File scripts\install_codex_skill.ps1Registra después este servidor MCP con el mismo nombre declarado por la skill:
codex mcp add blender-character-pipeline `
--env BLENDER_MCP_WORKSPACE_ROOTS=C:\ruta\a\Repos `
-- uv --directory C:\ruta\a\blender-MCP run blender-mcpReinicia Codex después de instalarla o actualizarla. Invócala explícitamente con $blender-character-pipeline, aunque también puede activarse al trabajar con personajes .blend, FBX, GLB, GLTF u OBJ.
Seguridad
Solo se permite
127.0.0.1,localhosto::1.No existe una operación de código arbitrario.
Las rutas se restringen con
BLENDER_MCP_WORKSPACE_ROOTS.Las mutaciones comienzan como simulaciones.
Importar, normalizar y renombrar pueden crear checkpoints del
.blendguardado.Los mensajes tienen límites de tamaño y tiempo.
Un proceso local que comparta la cuenta del sistema sigue teniendo acceso a los mismos archivos. Usa un token cuando convivan procesos que no sean de confianza.
Flujo recomendado para personajes
Consultar estado y resumen de escena.
Simular la generación
ether-forger,ether-forger-v2o la importación y luego ejecutarla explícitamente.Validar armadura, mallas, presupuesto y clips.
Simular y ejecutar la normalización.
Renombrar clips a
Idle,Walk,Run,Attack,Dodge,HityDeath.Validar otra vez.
Simular y ejecutar la exportación GLB.
Conservar el archivo fuente y la licencia del activo.
Desarrollo
uv run ruff check .
uv run pytest --cov=blender_mcp --cov-report=term-missing
uv run python scripts/smoke_mcp.pyLa prueba de humo inicia el servidor por stdio, negocia una sesión MCP real, enumera las herramientas y comprueba blender_status. Las pruebas del puente usan un Blender simulado; las operaciones bpy deben comprobarse adicionalmente dentro de Blender.
Con la copia portátil, la integración real se comprueba en modo de fábrica y sin interfaz:
& '.\.tools\blender-4.5.10-windows-x64\blender.exe' `
--background --factory-startup --python scripts\blender_integration_test.pyEl contrato JSONL entre el servidor y el complemento está documentado en docs/BRIDGE_PROTOCOL.md.
Licencia
MIT. Las licencias de modelos, texturas y animaciones procesados por este servidor permanecen bajo sus términos originales.
Available Tools
9 toolsblender_create_humanoid_characterB
Plan or generate an original rigged humanoid with seven canonical game actions.
Inputs: name, dry_run, height_m, archetype, +2 more.
blender_export_character_glbB
Plan or export one armature and its bound meshes as an optimized game-ready GLB.
Inputs: filepath (required), dry_run, armature_name, include_animations.
blender_import_assetB
Plan or import a supported character asset. Mutation requires dry_run=false.
Inputs: filepath (required), dry_run, create_checkpoint.
blender_list_objectsA
List Blender scene objects without modifying the scene.
Inputs: limit, object_type.
blender_normalize_characterC
Plan or normalize a character's height, horizontal center, and ground placement.
Inputs: dry_run, center_xy, armature_name, place_on_ground, +2 more.
blender_rename_actionsB
Plan or rename Blender actions to stable game-facing clip names.
Inputs: mapping (required), dry_run, create_checkpoint.
blender_scene_summaryA
Summarize the open Blender file, object counts, armatures, meshes, actions, and save state.
Inputs: no named parameters.
blender_statusA
Check whether the local Blender add-on bridge is running and report its capabilities.
Inputs: no named parameters.
blender_validate_characterA
Validate a humanoid for game export: rig, meshes, actions, bounds, triangles, and materials.
Inputs: armature_name, material_budget, triangle_budget, required_actions.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct stage or aspect of the character pipeline: status, scene info, object listing, import, creation, validation, normalization, action renaming, and export. There is no meaningful overlap between tool purposes, and descriptions clearly distinguish read-only actions from mutating ones.
All tools share the 'blender_' prefix and use snake_case, with most following a verb_noun pattern (import_asset, list_objects, validate_character). The exceptions are blender_status and blender_scene_summary, which use noun-only or noun_noun naming, creating a minor inconsistency.
With 9 tools, the set is well-scoped for the stated domain of Blender character preparation and export. Each tool covers a necessary step without redundant or excessive additions, fitting comfortably within the ideal 3-15 range.
The toolset covers the core lifecycle for character assets: import, create, validate, normalize, rename actions, and export. Minor gaps exist (e.g., no tool for direct editing of meshes or armatures), but the provided suite is sufficient for a complete character pipeline from import to game-ready export.
Maintenance
Related MCP Connectors
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
3D avatar/asset foundry: text/image -> rigged, validated, engine-ready GLB via x402.
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables remote control of Blender through MCP, allowing code execution, scene manipulation, rendering, and file transfer in a containerized environment.1-
- AlicenseCqualityBmaintenanceEnables secure, local automation of Blender through typed MCP tools for scene, modeling, material, animation, rendering, and file workflows via an authenticated loopback bridge.173MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to control Blender for modeling, materials, animation, physics, rendering, scene inspection, documentation search, and asset/generation service integration. It exposes a stdio endpoint with many Blender operations for creating and editing 3D content.AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables MCP-capable AI clients to control a local Blender workstation through a secure HTTP gateway for 3D scene inspection, modeling, rigging, animation, materials, rendering, import/export, and controlled Python automation. Supports permission profiles and authentication modes to keep Blender execution local while allowing AI-assisted production workflows.1MIT