Blender-Mind-MCP
Blender-Mind-MCP (프로덕션 AI 3D 모델링 & Blender 브리지)
자동화된 3D 모델링, 절차적 에셋 생성, 셰이더 작성, 멀티모달 뷰포트 검사를 위한 프로덕션급 Model Context Protocol (MCP) 서버 및 Blender 애드온 생태계.
🏗️ 선행 기술 및 아키텍처 영감
이 프로젝트는 주요 GitHub Blender AI 프로젝트(예: ahujasid/blender-mcp, djeada/blender-mcp-server)의 아키텍처 교훈과 벤치마크를 통합합니다:
스레드 안전 메인 스레드 디스패칭: Blender의 Python C-API(
bpy)는 스레드 안전하지 않습니다. 커뮤니티 이슈 감사에서 발견된 바와 같이, 원시 소켓 리스너 스레드 내에서bpy호출을 실행하면 메모리 손상 및 세그멘테이션 폴트가 발생합니다. 당사의 Blender 애드온은 스레드 안전한queue.Queue와bpy.app.timers를 결합하여 모든 씬 수정이 Blender의 메인 렌더/GUI 루프에서 엄격히 실행되도록 보장합니다.실행 취소 단계 격리: 모든 AI 코드 실행은
bpy.ops.ed.undo_push()로 감싸져 Blender 내부에서 원활한Ctrl+Z롤백을 가능하게 합니다.멀티모달 뷰포트 캡처: 오프스크린 OpenGL 렌더링(
bpy.ops.render.opengl)을 사용하여 3D 뷰포트의 Base64 인코딩 PNG 스크린샷을 멀티모달 비전 모델에 직접 반환합니다.헥사고날 아키텍처 (포트 & 어댑터): 순수 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에 애드온 설치
Blender(3.6+ 또는 4.x)를 엽니다.
Edit > Preferences > Add-ons > Install...(또는 4.2+의 Install from Disk 화살표)로 이동합니다.
addon/blender_mcp_addon.py를 선택합니다.Development: Blender MCP Bridge를 활성화합니다.
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 도구
도구 이름 | 설명 | 주요 기능 |
| 절차적 3D 메시 생성 |
|
| 절차적 모디파이어 부착 |
|
| PBR Principled BSDF 셰이더 |
|
| 광원 위치 및 튜닝 |
|
| 카메라 프레이밍 및 렌즈 |
|
| 시각적 뷰포트 스냅샷 | Base64 PNG 이미지를 멀티모달 LLM에 직접 반환 |
| 3D 모델 베이킹 및 내보내기 |
|
| 토폴로지 및 씬 트리 검사 | 계층적 객체 목록, 폴리곤 수, 버텍스 수, 모디파이어 |
| 원시 파라미터 Python 실행 | stdout/stderr 캡처가 포함된 샌드박스 실행 |
| 시스템 진단 | 활성 드라이버, 포트 상태, Blender 빌드 보고 |
🧪 진실 사다리 검증
npm test4단계 진실 사다리에서 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 파이프 왕복 테스트.
Maintenance
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
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to control Blender 3D software through natural language commands, supporting object creation, manipulation, materials, rendering, and scene management with 22 tools organized across 6 categories.
- AlicenseNot gradedqualityDmaintenanceExposes 50+ Blender tools (object manipulation, materials, animation, etc.) via MCP for AI-driven 3D workflows and automation.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered 3D content creation in Blender through natural language, including text-to-3D, image-to-3D, animation, rigging, rendering, and export.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to control Blender via MCP tools for scene manipulation, material assignment, rendering, and Python script execution.22MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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