Skip to main content
Glama
Blender Universal & Token-Efficient MCP Server

Blender Universal & Token-Efficient MCP Server

by domainjon

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

  1. 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 -b buyrug'i orqali fonda xuddi shu operatsiyalarni bajaradi.

  2. 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.

  3. Nol Tashqi Pip Bog'liqligi (Blender ichida Zero Dependencies):

    • Blender ichiga birorta ham qo'shimcha pip paket o'rnatish shart emas! Standart Python kutubxonasi (socket, threading, bpy) orqali ishlaydi.

  4. 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.

  5. 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_ping

Blender bilan aloqani, ochilgan fayl nomi, faol sahna va versiyani tekshiradi.

Jonli / Oflayn

blender_get_scene_info

Faol kamera, render dvigateli (Cycles/EEVEE), FPS, kadrlar chegarasi va obyektlar soni.

Gibrid

blender_get_outliner

Sahnadagi barcha kolleksiyalar va obyektlar iyerarxiyasi (token-tejamkor ixcham format).

Gibrid

blender_inspect_object

Bitta obyektning koordinatalari, mesh statistikasi, modifikatorlari, materiallari va ota-onasi.

Gibrid

blender_create_object

Mesh primitivlari (cube, sphere, cylinder, plane, monkey va h.k.), kamera yoki yorug'lik yaratish.

Gibrid

blender_modify_object

Obyekt koordinatalari (location), burchagi (rotation), masshtabi (scale), nomi yoki ko'rinishi.

Gibrid

blender_manage_modifiers

Modifikator qo'shish (Subsurf, Bevel, Mirror, Boolean), parametrlarini sozlash yoki o'chirish.

Gibrid

blender_manage_material

Material yaratish, Principled BSDF parametrlarini sozlash (Rang, Metallik, G'adir-budurlik) va biriktirish.

Gibrid

blender_render_viewport

Viewport yoki to'liq sahnani tezkor rasmga olib diskda PNG saqlash va fayl yo'lini qaytarish.

Gibrid

blender_export_asset

Sahnani yoki tanlangan obyektlarni GLTF/GLB, FBX yoki OBJ formatida eksport qilish.

Gibrid

blender_execute_script

Blender ichida ixtiyoriy Python (bpy) skriptini bajarish va stdout/stderr natijasini olish.

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.py

Bu skript:

  1. Blender Add-onni barcha aniqlangan Blender versiyalarining scripts/addons papkasiga avtomatik nusxalaydi.

  2. blender MCP serverini ~/.gemini/config/mcp_config.json fayliga ulaydi.

  3. Qo'lda o'rnatish uchun mcp_blender_bridge_addon.zip paketini yaratadi.

3-qadam: Blenderda Add-onni faollashtirish

  1. Blenderni oching.

  2. Edit > Preferences > Add-ons bo'limiga kiring.

  3. Qidiruv maydoniga "MCP Blender Bridge" deb yozing va qutichani belgilab faollashtiring.

  4. 3D Viewportda N tugmasini 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 tools
blender_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

    A3.7/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -