Blender MCP

Name: Blender MCP MCP Server
Author: ahujasid

왜 쓰나요

핵심 기능

직접 bpy 실행 — 스크립트로 할 수 있는 것은 Claude도 구동 가능
씬 검사: 오브젝트 나열, 속성 가져오기, 머티리얼 검사
PolyHaven 통합: HDRI, 텍스처, 모델 검색 및 가져오기
Hyper3D rodin: 텍스트 또는 이미지로 AI 3D 모델 생성
무료 모델 탐색을 위한 Sketchfab 검색 내장

라이브 데모

실제 사용 모습

blender-mcp-ahujasid.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Blender MCP

Blender UI를 건드리지 않고 텍스트 프롬프트로 3D 씬 만들기

👤 모델링에 익숙하지 않은 디자이너, 인디 개발자, 취미 제작자 ⏱ ~30 min beginner

언제 쓸까: 빠른 3D 씬 목업이 필요하지만 Blender 단축키를 배우고 싶지 않을 때.

사전 조건

Blender 3.0+ 설치 — blender.org에서 다운로드
Blender MCP 애드온 활성화 — Edit > Preferences > Add-ons > Install from disk

흐름

Claude를 Blender에 연결

Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ 복사됨

→ 빈 씬 목록(Cube, Camera, Light)이 표시되어 라이브 연결 확인
씬 구성

Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ 복사됨

→ 뷰포트에 실시간으로 오브젝트 등장
분위기 추가

Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ 복사됨

→ 조명 분위기가 있는 씬, 렌더에서 안개 확인 가능

결과: 채팅으로 완전히 구성된 프로토타입 3D 씬, 추가 정제 준비 완료.

함정

세션 중간에 Blender 연결 끊김 — N-패널에서 재연결; 애드온은 로컬 소켓에서 대기

Hyper3D rodin으로 3D 에셋을 생성하고 직접 가져오기

👤 빠른 에셋 반복이 필요한 게임 개발자와 프로토타이퍼 ⏱ ~20 min intermediate

언제 쓸까: 고유한 소품이 필요하지만 처음부터 모델링하거나 마켓플레이스 에셋 비용을 지불하고 싶지 않을 때.

사전 조건

Hyper3D rodin API 키 (무료 티어 이용 가능) — hyper3d.ai에서 가입 후 HYPER3D_RODIN_API_KEY 설정

흐름

프롬프트로 생성

Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ 복사됨

→ 생성 작업 시작, 완료 시 메시 가져오기 (~30초)
필요시 수정 후 재가져오기

The mesh is too dense. Decimate to 5k tris and reimport.✓ 복사됨

→ 데시메이트된 메시가 원본 교체

결과: Claude를 벗어나지 않고 생성 및 조정된 커스텀 3D 소품.

함정

무료 티어에서 생성 대기열이 혼잡 — 지수 백오프로 재시도하거나 티어 업그레이드

bpy를 통해 많은 오브젝트에 대한 배치 작업 실행

👤 TD와 파이프라인 엔지니어 ⏱ ~25 min advanced

언제 쓸까: 계층 이름 변경, 머티리얼 재타겟팅, 배치 UV 언래핑 등 지루한 대량 작업이 필요할 때.

흐름

작업 설명

Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ 복사됨

→ Claude가 bpy 스니펫을 작성하고 실행 전 확인 요청
안전망과 함께 실행

Show me the script first. If it looks safe, execute. Otherwise revise.✓ 복사됨

→ 스크립트 표시, 실행 적용, 영향받은 오브젝트 수 보고

결과: 완전한 감사 추적과 함께 수초 내에 대량 씬 작업 완료.

함정

잘못된 스크립트로 Blender 충돌 — bpy 실행 전 저장; 애드온은 샌드박스 처리하지 않음

조합

다른 MCP와 조합해 10배 효율

blender-mcp-ahujasid + filesystem

렌더 및 내보내기를 디스크에 저장

After rendering, save the PNG to ~/Renders/today.png via filesystem MCP.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
execute_blender_code	code: str	직접적인 bpy 작업 시	0
get_scene_info	()	씬에 무엇이 있는지 파악하기 위한 첫 번째 호출	0
get_object_info	name: str	편집 전 특정 오브젝트 검사	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	무료 PBR 에셋 찾기	0
polyhaven_download_asset	asset_id, resolution	HDRI/텍스처 가져오기 및 적용	0
generate_hyper3d_model_via_text	prompt: str	AI로 3D 모델 생성	1 generation credit

비용 및 제한

운영 비용

API 쿼터: PolyHaven: 무제한 무료. Hyper3D: 무료 티어 하루 ~20회 생성
호출당 토큰: 호출당 100~800 (씬 상태가 장황할 수 있음)
금액: 무료 애드온. Hyper3D 유료 티어 월 $10부터
팁: Hyper3D 생성 비용 지불 전 Sketchfab과 PolyHaven을 먼저 활용

보안

권한, 시크릿, 파급범위

최소 스코프: blender-bpy-exec filesystem-write (for downloads)

자격 증명 저장: Hyper3D 키를 환경 변수에 저장

데이터 외부 송신: PolyHaven CDN, Hyper3D API

execute_blender_code는 Blender에서 임의 Python을 실행 — 알 수 없는 스크립트는 실행 전 검토 필요

문제 해결

자주 발생하는 오류와 해결

연결 거부

Blender가 열려 있고 애드온의 'Connect to Claude'가 활성화되어 있는지 확인; 기본 포트 9876

Hyper3D 생성이 멈춤

HYPER3D_RODIN_API_KEY 환경 변수 확인; hyper3d.ai에서 티어 할당량 확인

편집 후 오브젝트를 찾을 수 없음

오브젝트 이름에 숫자 접미사(.001)가 붙을 수 있음 — get_scene_info로 새로고침

대안

Blender MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Unity MCP / Unreal MCP	파이프라인이 DCC 툴보다 게임 엔진 중심일 때	엔진 MCP는 런타임/씬을 대상으로 하고, Blender MCP는 저작 도구를 대상으로 함
Cesium MCP	지리공간/월드 스케일 3D가 필요할 때	Cesium은 지리참조 씬용, Blender는 자유형 제작용

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: Blender MCP

Blender UI를 건드리지 않고 텍스트 프롬프트로 3D 씬 만들기

사전 조건

흐름

함정

Hyper3D rodin으로 3D 에셋을 생성하고 직접 가져오기

사전 조건

흐름

함정

bpy를 통해 많은 오브젝트에 대한 배치 작업 실행

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

Blender MCP 다른 것과 비교

더 보기

리소스