Blender Ai Mcp

Name: Blender Ai Mcp
Author: PatrykIti

@PatrykIti

代码仓库

关于 Blender Ai Mcp

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

#blender #mcp

基本信息

分类

其他

传输方式

stdio

发布者

PatrykIti

提交者

PCITI

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.