Blender Universal & Token-Efficient MCP Server
Provides tools for interacting with Blender 3D scenes, enabling inspection of scene data, creation and modification of objects, management of materials and modifiers, rendering viewports, exporting assets, and execution of bpy scripts through either a live Blender editor connection or headless CLI mode.
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 Universal & Token-Efficient MCP Server Create a red metallic sphere at the origin and render a preview."
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.
Blender Universal & Token-Efficient MCP Server
Blender 3D bilan ishlashda AI agentlar (Antigravity, Claude Code, Cursor, Windsurf va h.k.) uchun maxsus yaratilgan Universal, Token-tejamkor va Gibrid Model Context Protocol (MCP) serveri.
Ushbu tizim Blender sahnasini qo'lda boshqarish, murakkab bpy skriptlarini yozish va xatolarni taxmin qilish o'rniga, token sarfini 80-90% gacha tejaydi va Blender Editor bilan real vaqtda bevosita muloqot qilish imkonini beradi.
π Asosiy Imkoniyatlar
Gibrid Rejim (Jonli Editor + Oflayn Headless CLI):
Jonli Rejim (Live Editor): Blender ochilganda TCP soketi (port 8190) orqali bevosita ulanadi. Barcha operatsiyalar Blenderning Main Thread'ida (
bpy.app.timers) xavfsiz bajariladi.Headless CLI Rejimi: Agar Blender ochiq bo'lmasa, server to'xtamaydi β
blender -bbuyrug'i orqali fonda xuddi shu operatsiyalarni bajaradi.
Token Tejamkorligi (Smart Outliner & Object Pruning):
Minglab vertex va poligonlardan iborat og'ir ma'lumotlar o'rniga LLM uchun eng muhim bo'lgan parametrlar (mesh statistikasi, transformatsiyalar, modifikatorlar va shader materiallari) ixcham formatda taqdim etiladi.
Nol Tashqi Pip Bog'liqligi (Blender ichida Zero Dependencies):
Blender ichiga birorta ham qo'shimcha
pippaket o'rnatish shart emas! Standart Python kutubxonasi (socket,threading,bpy) orqali ishlaydi.
Blender 3D Viewport N-Panel UI:
3D Viewport Sidebar (N) da MCP Bridge paneli mavjud: Port sozlash (standart 8190), Start/Stop qilish va ulangan mijozlar monitoringi.
Avtomatlashtirilgan O'rnatish (
install_global.py):Windows tizimidagi barcha Blender versiyalarini (
%APPDATA%\Blender Foundation\Blender\<ver>\scripts\addons) avtomatik topib, add-onni to'g'ridan-to'g'ri o'rnatadi hamda Antigravity / AI konfiguratsiyasiga ro'yxatdan o'tkazadi.
Related MCP server: Blender Open MCP
π Taqdim Etiladigan Asosiy MCP Vositalari (Tools)
Vositachi (Tool) | Tavsifi | Rejim |
| Blender bilan aloqani, ochilgan fayl nomi, faol sahna va versiyani tekshiradi. | Jonli / Oflayn |
| Faol kamera, render dvigateli (Cycles/EEVEE), FPS, kadrlar chegarasi va obyektlar soni. | Gibrid |
| Sahnadagi barcha kolleksiyalar va obyektlar iyerarxiyasi (token-tejamkor ixcham format). | Gibrid |
| Bitta obyektning koordinatalari, mesh statistikasi, modifikatorlari, materiallari va ota-onasi. | Gibrid |
| Mesh primitivlari ( | Gibrid |
| Obyekt koordinatalari ( | Gibrid |
| Modifikator qo'shish ( | Gibrid |
| Material yaratish, Principled BSDF parametrlarini sozlash (Rang, Metallik, G'adir-budurlik) va biriktirish. | Gibrid |
| Viewport yoki to'liq sahnani tezkor rasmga olib diskda PNG saqlash va fayl yo'lini qaytarish. | Gibrid |
| Sahnani yoki tanlangan obyektlarni | Gibrid |
| Blender ichida ixtiyoriy Python ( | Gibrid |
π 1 Daqiqalik O'rnatish Qo'llanmasi
1-qadam: Virtual muhit va bog'liqliklarni o'rnatish
Loyiha papkasida terminal ochib:
# Virtual muhit yaratish
uv venv
# Bog'liqliklarni o'rnatish
uv pip install -e .2-qadam: Global ro'yxatdan o'tkazish va Add-onni o'rnatish
python install_global.pyBu skript:
Blender Add-onni barcha aniqlangan Blender versiyalarining
scripts/addonspapkasiga avtomatik nusxalaydi.blenderMCP serverini~/.gemini/config/mcp_config.jsonfayliga ulaydi.Qo'lda o'rnatish uchun
mcp_blender_bridge_addon.zippaketini yaratadi.
3-qadam: Blenderda Add-onni faollashtirish
Blenderni oching.
Edit > Preferences > Add-ons bo'limiga kiring.
Qidiruv maydoniga "MCP Blender Bridge" deb yozing va qutichani belgilab faollashtiring.
3D Viewportda
Ntugmasini bosing β o'ng tomondagi panelda "MCP Bridge" yorlig'ini ko'rasiz! Server avtomatik ravishda 8190 portida faol bo'ladi.
π‘ Foydalanish Misollari
Blender holatini tekshirish:
"Blender holatini tekshir (blender_ping)"
Sahnani ko'rish:
"Sahnadagi barcha kolleksiyalar va obyektlarni ko'rsat (blender_get_outliner)"
Obyekt yaratish va material berish:
"Sahnaga bitta Sphere yarat va unga oltin rangli metall material ber"
Rasm olish:
"Hozirgi sahnaning renderini ol va rasmni ko'rsat"
Ixtiyoriy procedural skript bajarish:
"bpy orqali spiral shaklida 20 ta kubik joylashtiradigan skriptni bajar"
Available Tools
11 toolsblender_create_objectC
Creates a new 3D primitive or entity in the Blender scene. Supported primitive_type: 'cube', 'uv_sphere', 'ico_sphere', 'cylinder', 'cone', 'plane', 'torus', 'monkey', 'circle', 'camera', 'light', 'empty', 'collection'. Location and scale are 3D floats [X, Y, Z]. Rotation is [X, Y, Z] in degrees.
Inputs: name, scale, location, rotation, +2 more. Returns: result
blender_execute_scriptA
Executes an arbitrary Python script inside Blender's Python runtime ('bpy'). Captures standard output (stdout), errors (stderr), and any variable named 'result'. Ideal for procedural modeling, complex operations, rigging, or custom automation.
Inputs: script (required). Returns: result
blender_export_assetB
Exports the current scene or selected objects to a 3D asset file. format: 'gltf' (or 'glb'), 'fbx', or 'obj'. selected_only: if True, exports only selected objects.
Inputs: filepath (required), format, selected_only. Returns: result
blender_get_outlinerB
Returns a token-efficient hierarchy of collections and objects in the current Blender scene. Filters by collection_name if specified. Includes object names, types, and visibility.
Inputs: max_depth, collection_name. Returns: result
blender_get_scene_infoA
Retrieves high-level scene configuration: active camera, render engine (Cycles / EEVEE), FPS, frame range, unit system, and object counts by type.
Inputs: no named parameters. Returns: result
blender_inspect_objectA
Inspects detailed properties of a specific Blender object: transforms (location, rotation in degrees, scale), mesh statistics (vertices, edges, polygons), applied modifiers, assigned materials, constraints, and parent/children relationships.
Inputs: object_name (required). Returns: result
blender_manage_materialB
Creates, assigns, or configures a Principled BSDF material on an object. action: 'assign', 'create', or 'remove'. color: RGBA or RGB float list [R, G, B, (A)], values between 0.0 and 1.0. roughness, metallic: float values between 0.0 and 1.0. emission: RGB float list, emission_strength: float multiplier.
Inputs: object_name (required), color, action, emission, +4 more. Returns: result
blender_manage_modifiersC
Manages modifiers on an object. action: 'add', 'remove', or 'apply'. modifier_type: e.g. 'SUBSURF', 'BEVEL', 'MIRROR', 'BOOLEAN', 'SOLIDIFY', 'ARRAY'. Optional properties:
levels: subdivision levels for SUBSURF
width, segments: for BEVEL
target_object, operation ('DIFFERENCE', 'UNION', 'INTERSECT'): for BOOLEAN
Inputs: object_name (required), width, action, levels, +5 more. Returns: result
blender_modify_objectA
Modifies an existing object in the scene: transforms (location, rotation in degrees, scale), renaming, viewport visibility, parenting, and moving to a collection.
Inputs: object_name (required), scale, parent, visible, +4 more. Returns: result
blender_pingA
Checks the connection status to the Blender Editor. Returns live connection state, active scene, Blender version, and mode if Blender is open with MCP Add-on. If Blender is closed, reports offline environment status and local .blend files detected on disk.
Inputs: no named parameters. Returns: result
blender_render_viewportA
Captures a viewport preview screenshot (fast OpenGL render) or triggers a full Cycles/EEVEE render. Saves the resulting PNG image to disk and returns the file path and resolution.
Inputs: full_render, output_path. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 11 tools
Each tool targets a distinct Blender operation: connection check, scene metadata, hierarchy, object inspection, export, script execution, object creation/modification, modifiers, materials, and rendering. Overlap is minimal; execute_script is a general escape hatch but clearly distinguished as arbitrary Python.
All 11 tools use the same blender_ prefix and snake_case verb_noun pattern (e.g., blender_create_object, blender_manage_material). Deviations are minor (e.g., blender_ping, blender_get_outliner) but still consistent and predictable.
11 tools is well within the 3β15 sweet spot for a domain-specific MCP server. Each tool covers a distinct high-level capability, avoiding redundancy.
Core lifecycle operations for scene objects are covered: create, inspect, modify, material, modifiers, export, render, plus a script escape hatch. However, no dedicated delete-object tool exists, and file save/load or selection management are absent; these can be worked around via blender_execute_script.
Maintenance
Related MCP Connectors
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Cloud Blender for AI agents: build, inspect, render and animate 3D scenes over remote MCP. Keep editable .blend projects and export GLB or STL. Make your first 3D asset freeβ30 compute minutes per UTC month, no credit card. First 100 eligible Free account owners to use all 30 minutes in one UTC month by December 31, 2026 UTC receive one calendar month of beta free: 4 compute hours per UTC month, 2 concurrent workers per deployment, 2 deployments, 2048Γ2048 renders at up to 256 samples, and 10 GiB storage. Existing usage counts toward the 4-hour allowance. Limited to 100 rewards; expires January 1, 2027 00:00 UTC. Free resumes afterward without an automatic charge. Examples, eligibility and terms: https://sceneplane.online/launch?utm_source=glama&utm_medium=directory&utm_campaign=first100
Blender and GLB/FBX/USD/STL rendered on cloud GPUs for AI agents: product shots, turntables, MP4
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to inspect and modify live Blender scenes, manage objects and materials, render images, retrieve PolyHaven assets, and send prompts to configurable local or OpenAI-compatible LLM backends.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to control a live Blender session, creating, modifying, and deleting objects, applying materials, rendering images, executing code, and pulling PolyHaven assets, while routing prompts through a provider-agnostic LLM backend that can be switched at runtime.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to control a live Blender session, inspect and modify scenes, manage PolyHaven assets, render images, and route prompts through configurable local or OpenAI-compatible LLM backends.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to control a live Blender session, manage scenes, objects, materials, and renders, download PolyHaven assets, and switch between multiple LLM backends at runtime.-