Blender Ai Mcp

@PatrykIti

About Blender Ai Mcp

Modular MCP Server + Blender Addon for AI-Driven 3D Modeling.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "blender-ai-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BLENDER_RPC_HOST=host.docker.internal",
        "ghcr.io/patrykiti/blender-ai-mcp:latest"
      ],
      "disabled": false,
      "autoApprove": [
        "scene_list_objects",
        "scene_delete_object",
        "scene_clean_scene",
        "scene_duplicate_object",
        "scene_set_active_object",
        "scene_get_viewport",
        "scene_create_light",
        "scene_create_camera",
        "scene_create_empty",
        "modeling_create_primitive",
        "modeling_transform_object",
        "modeling_add_modifier",
        "modeling_apply_modifier",
        "modeling_convert_to_mesh",
        "modeling_join_objects",
        "modeling_separate_object",
        "modeling_set_origin",
        "modeling_list_modifiers"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Blender Ai Mcp?

Blender Ai Mcp is a Model Context Protocol server that acts as a stable translation layer for AI interactions with Blender, handling Blender’s complex internal state machine so the AI can focus on 3D creativity. It is designed for users who want AI to reliably create and edit 3D scenes without the crash-prone failures of raw Python scripting.

How to use Blender Ai Mcp?

—

Key features of Blender Ai Mcp

Sandboxed, validated endpoints for safe AI operations
Phase 1 tools: scene management, object creation, transforms, modifiers
Vision capability: AI can see the viewport via get_viewport
Structured roadmap for mesh editing and macro tools

Use cases of Blender Ai Mcp

AI‑driven 3D modeling without script‐execution risk
Generating complex blockouts (e.g., organic forms, hard‑surface parts)
Composing scenes with lights, cameras, and primitives
Applying and managing object modifiers via AI commands

FAQ from Blender Ai Mcp

Why use Blender Ai Mcp instead of raw Python code?

Raw scripts often fail due to AI hallucinations (outdated bpy API), context errors (wrong modes/selections), missing feedback loops, and safety risks. Blender Ai Mcp returns precise error messages and operates as sandboxed endpoints.

What capabilities are currently available?

Phase 1 (Object & Scene Management) is complete, including scene operations, creation of lights/cameras/empties, primitive creation, transform tools, modifier management, and object structure operations like join/separate/convert.

What is the roadmap for future features?

Phase 2 (Mesh Editing) is next with tools like extrude, loop cut, bevel, and boolean. Phase 3 adds materials and export. Phase 4 introduces high‑level macro tools for complex tasks like organify, phone base generation, and retopology.

Frequently asked questions

Why use Blender Ai Mcp instead of raw Python code?

Raw scripts often fail due to AI hallucinations (outdated `bpy` API), context errors (wrong modes/selections), missing feedback loops, and safety risks. Blender Ai Mcp returns precise error messages and operates as sandboxed endpoints.