Skip to main content
Glama
xiaohai-uid

Blender-Mind-MCP

by xiaohai-uid

Blender-Mind-MCP (프로덕션 AI 3D 모델링 & Blender 브리지)

자동화된 3D 모델링, 절차적 에셋 생성, 셰이더 작성, 멀티모달 뷰포트 검사를 위한 프로덕션급 Model Context Protocol (MCP) 서버 및 Blender 애드온 생태계.


🏗️ 선행 기술 및 아키텍처 영감

이 프로젝트는 주요 GitHub Blender AI 프로젝트(예: ahujasid/blender-mcp, djeada/blender-mcp-server)의 아키텍처 교훈과 벤치마크를 통합합니다:

  1. 스레드 안전 메인 스레드 디스패칭: Blender의 Python C-API(bpy)는 스레드 안전하지 않습니다. 커뮤니티 이슈 감사에서 발견된 바와 같이, 원시 소켓 리스너 스레드 내에서 bpy 호출을 실행하면 메모리 손상 및 세그멘테이션 폴트가 발생합니다. 당사의 Blender 애드온은 스레드 안전한 queue.Queuebpy.app.timers를 결합하여 모든 씬 수정이 Blender의 메인 렌더/GUI 루프에서 엄격히 실행되도록 보장합니다.

  2. 실행 취소 단계 격리: 모든 AI 코드 실행은 bpy.ops.ed.undo_push()로 감싸져 Blender 내부에서 원활한 Ctrl+Z 롤백을 가능하게 합니다.

  3. 멀티모달 뷰포트 캡처: 오프스크린 OpenGL 렌더링(bpy.ops.render.opengl)을 사용하여 3D 뷰포트의 Base64 인코딩 PNG 스크린샷을 멀티모달 비전 모델에 직접 반환합니다.

  4. 헥사고날 아키텍처 (포트 & 어댑터): 순수 3D 지오메트리 생성을 물리적 드라이버에서 분리하여 라이브 소켓 연결(127.0.0.1:9876), 헤드리스 CLI 배치(blender -b), 오프라인 절차적 glTF 바이너리 시뮬레이션을 모두 지원합니다.


Related MCP server: Blender MCP Server

📦 프로젝트 구조

blender-mind-mcp/
├── addon/
│   └── blender_mcp_addon.py       # Full Blender 3.x/4.x Addon (UI Sidebar Panel, Socket Server, Viewport Capture)
├── src/
│   ├── index.ts                   # stdio JSON-RPC MCP Server entry point
│   ├── bridge/
│   │   └── socket_client.ts       # Robust TCP Socket Client with reconnect & timeout handling
│   ├── core/
│   │   └── domain/
│   │       ├── types.ts           # 3D Domain Types (Scene, Mesh, Material, Modifier, Transform)
│   │       ├── scene.ts           # Pure in-memory 3D scene graph & polygon math
│   │       └── bpy_generator.ts   # Modern Blender 4.x/3.x Python code synthesizer
│   ├── ports/
│   │   └── driver.port.ts         # BlenderDriverPort interface specification
│   ├── adapters/
│   │   ├── live_socket.adapter.ts # Live Socket Adapter (talks to active Blender GUI)
│   │   ├── blender_cli.adapter.ts # Headless CLI Adapter (talks to blender.exe)
│   │   └── mock_geometry.adapter.ts # Offline Simulation Adapter (glTF & OBJ binary synthesis)
│   └── tools/
│       └── index.ts               # 10 MCP Tools registry & dispatcher
├── tests/
│   ├── unit/                      # L1: Domain math & Python code generation
│   ├── contract/                  # L2: MCP tool schemas & argument contracts
│   ├── integration/               # L3: Binary glTF headers & TCP Socket Bridge
│   └── run_tests.ts               # Complete Truth Ladder test runner
├── package.json
└── tsconfig.json

🚀 빠른 시작

1. Blender에 애드온 설치

  1. Blender(3.6+ 또는 4.x)를 엽니다.

  2. Edit > Preferences > Add-ons > Install...(또는 4.2+의 Install from Disk 화살표)로 이동합니다.

  3. addon/blender_mcp_addon.py를 선택합니다.

  4. Development: Blender MCP Bridge를 활성화합니다.

  5. 3D 뷰포트에서 N을 눌러 사이드바를 열고, Blender MCP 탭을 클릭한 다음 Start MCP Server를 클릭합니다.

2. MCP 클라이언트 구성 (Antigravity / Claude / Codex)

프로젝트 또는 전역 MCP 구성(.mcp.json)에 추가합니다:

{
  "mcpServers": {
    "blender": {
      "command": "node",
      "args": [
        "--disable-warning=ExperimentalWarning",
        "--experimental-strip-types",
        "C:/Users/a1691/Documents/antigravity/noble-hypatia/src/index.ts"
      ]
    }
  }
}

🛠️ 10가지 핵심 MCP 도구

도구 이름

설명

주요 기능

blender_create_primitive

절차적 3D 메시 생성

cube, sphere, cylinder, torus, plane, cone, monkey

blender_apply_modifier

절차적 모디파이어 부착

subsurf, bevel, boolean, mirror, array, solidify

blender_procedural_material

PBR Principled BSDF 셰이더

base_color, metallic, roughness, transmission(유리), emission

blender_setup_lighting

광원 위치 및 튜닝

SUN, POINT, SPOT, AREA(와트, 반경, 색상 틴트)

blender_setup_camera

카메라 프레이밍 및 렌즈

location, look_at 추적, focal_length(mm)

blender_capture_viewport

시각적 뷰포트 스냅샷

Base64 PNG 이미지를 멀티모달 LLM에 직접 반환

blender_export_asset

3D 모델 베이킹 및 내보내기

.glb, .gltf, .obj, .stl, .fbx

blender_inspect_scene

토폴로지 및 씬 트리 검사

계층적 객체 목록, 폴리곤 수, 버텍스 수, 모디파이어

blender_execute_bpy

원시 파라미터 Python 실행

stdout/stderr 캡처가 포함된 샌드박스 실행

blender_health

시스템 진단

활성 드라이버, 포트 상태, Blender 빌드 보고


🧪 진실 사다리 검증

npm test

4단계 진실 사다리에서 6개 테스트 스위트를 모두 실행합니다:

  • L1 Unit: 100% 순수 도메인 모델링 및 Python 코드 신디사이저 AST 검사.

  • L2 Contract: 10개 도구 모두에 대한 스키마 정의 및 디스패치 검증.

  • L3 Integration: 바이너리 glTF v2 헤더(0x46546C67) 및 OBJ 구조 검증.

  • L3 Integration: 127.0.0.1:9899에서 라이브 TCP 소켓 클라이언트-서버 루프백 테스트.

  • L4 E2E: 라이브 stdio JSON-RPC 파이프 왕복 테스트.

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…

  • AI visual generation agent: multi-pipeline rendering, prompt crafting, and image composition.

  • Build and run visual creative-production workflows from your AI agent.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xiaohai-uid/blender-mind-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server