Skip to main content
Glama

IRSofka Blender MCP

A stdio Model Context Protocol server for Blender on the Irsofka AI Workstation: it drives a self-run Blender session over the add-on's TCP socket, denies dangerous execution before code leaves the server, and refuses heavy work the station's VRAM meter cannot pay for. Licensed Business Source License 1.1 for the entire work, with Change License Apache License, Version 2.0.

The server connects to Blender's TCP socket add-on (default 127.0.0.1:9876) and carries no third-party code; the provenance record — reference project, licence, and measured overlap — lives in UPSTREAM.

$ python3 server.py --surface-policy  # what is registered right now, and what is pending consent
$ python3 server.py --selftest        # 19 checks, no Blender running, no network out

Architecture and Safety Policies

  1. Protocol from the receiver side: speaks JSON-over-socket with Blender's listening add-on on 127.0.0.1:9876 (or IRSOFKA_BLENDER_PORT). If Blender is not running, requests return structured error_type: "BRIDGE_OFFLINE" with connection hints, never crashing.

  2. Telemetry disabled: DISABLE_TELEMETRY=1 is enforced before startup.

  3. Safe mode active: BLENDER_MCP_SAFE_MODE=1 denies dangerous system execution calls before sending code to Blender.

  4. Outbound network gating: tools reaching outside the machine (generate_3d, search_assets, import_asset) are not registered unless IRSOFKA_BLENDER_ALLOW_NETWORK=1 is set.

  5. Station VRAM gate: vram.decide() guards heavy operations. On unmetered systems without a workstation gate, it answers UNKNOWN and refuses rather than issuing an unmeasured permit. IRSOFKA_BLENDER_GATE=off is the explicit override producing BYPASSED.

Related MCP server: blender-unified

Tools

group

tools

local scene & execution (ours)

get_scene_info, execute_blender_code, get_object_info, list_scene_items, get_viewport_screenshot, export_scene

network assets (ours, gated)

generate_3d, search_assets, import_asset (require IRSOFKA_BLENDER_ALLOW_NETWORK=1)

station layer (ours)

irsofka_gpu_gate, irsofka_surface_policy

License

Business Source License 1.1, LICENSE in this directory. Licensor PT IRSofka Data Teknologi, Change Date four years after publication, Change License Apache License, Version 2.0. See NOTICE for brand attribution.

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    C
    maintenance
    Enables AI agents to inspect and drive Blender scenes directly, either through a live editor bridge on port 8190 or automatically via headless background CLI when Blender is closed. Provides token-efficient tools for scene outlining, object creation and modification, modifiers, materials, rendering, asset export, and arbitrary bpy script execution.
    11
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to drive a live Blender session over MCP by creating and transforming primitives, building and assigning materials, inspecting scenes and objects, capturing viewport screenshots, and executing arbitrary bpy Python. Commands are relayed over a local TCP bridge to a Blender add-on and executed on Blender's main thread, supporting multiple simultaneous AI clients.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Connects an AI agent to Blender 5.2 LTS over stdio, letting it read the scene hierarchy, create and transform primitive meshes, assign Principled BSDF materials, delete objects, save .blend files, and run raw bpy scripts through 12 tools. A two-process socket bridge keeps bpy calls on Blender's main thread, so no pip packages or admin rights are needed inside Blender.
    MIT