Blender AI

Blender AI는 로컬 웹 UI와 Blender MCP 연결을 한 레포지토리에서 끝내는 모노레포입니다. 새 Windows/Mac PC에서도 이 레포만 내려받으면 필요한 설치 순서와 설정 파일을 같은 위치에서 관리할 수 있습니다.

구성

.
├─ web/                 # Blender AI 웹 UI + 로컬 API 서버
├─ blender-mcp/         # vendored Blender MCP server/add-on source
├─ scripts/             # Windows/macOS bootstrap + MCP config generator
├─ config/              # MCP client config example/local generated config
└─ docs/                # 처음 설치 가이드

불필요한 음성/Realtime 실험 코드는 제거했습니다. 기본 제품 흐름은 중앙 입력 UI → 이미지 첨부 → Blender 실행 계획 생성 → 사용자 승인 → 로컬 Blender/MCP 실행입니다.

빠른 시작

macOS

# 레포 루트에서
./scripts/bootstrap.sh

Windows PowerShell

# 레포 루트에서
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
.\scripts\bootstrap.ps1

bootstrap은 Git/Bun/uv/Node/Blender를 설치 또는 확인하고 web 의존성을 설치합니다.

AI 계획 생성 설정

웹 UI의 작업 계획 생성은 OpenAI API를 실제 호출합니다. 레포 루트의 .env.local에 두는 것을 기본으로 합니다.

cp .env.example .env.local
# .env.local 수정:
# OPENAI_API_KEY=sk_...
# OPENAI_MODEL=gpt-5.5
# OPENAI_MODEL_FALLBACKS=gpt-4.1,gpt-4o

환경 변수 우선순위는 실제 shell env > web/.env.local > web/.env > .env.local > .env 입니다.

MCP 설정

Blender MCP 클라이언트 설정 파일을 생성합니다.

bun run mcp:config

생성 파일:

config/mcp-servers.local.json

Claude Desktop 설정에 바로 병합하려면:

bun run mcp:config -- --write-claude

실행

bun run dev

동시 실행 항목:

• API: http://127.0.0.1:8787
• UI: http://127.0.0.1:5173

MCP URL을 웹 LED 상태에 연결하려면:

bun run mcp:connect http://127.0.0.1:3333/mcp
bun run mcp:check

전체 설치 문서

처음 PC 기준 순서, Blender add-on 설치, MCP 클라이언트 설정은 아래 문서에 정리했습니다.

• docs/SETUP.md

개발 명령

bun run setup      # web 의존성 설치
bun run dev        # API + UI 동시 실행
bun run mcp:check  # API/UI/MCP 상태 확인
bun run check      # TypeScript typecheck