블렌더-mcp 사용 가이드: Claude AI와 블렌더 연동으로 3D 제작 혁신하기

블렌더-mcp 사용 가이드: Claude AI와 블렌더 연동으로 3D 제작 혁신하기

안녕하세요! 이번 포스팅에서는 블렌더와 Claude AI를 연결하여 3D 작업 효율을 극대화할 수 있는 '블렌더-mcp' 도구에 대해 상세히 알아보겠습니다. AI 기술을 활용해 3D 모델링과 장면 제작을 더욱 쉽고 빠르게 만들어주는 이 도구의 설치부터 활용법까지 단계별로 안내해 드리겠습니다.

목차

1. 블렌더-mcp란?
2. 설치 준비사항
3. 설치 방법
4. 사용 방법
5. 문제 해결 가이드
6. 보안 고려사항
7. 활용 사례

블렌더-mcp란?

블렌더-mcp는 블렌더와 인공지능 모델 Claude를 연결하여 3D 작업 과정을 혁신적으로 개선하는 도구입니다. 이 도구를 통해 다음과 같은 작업을 자연어 명령만으로 수행할 수 있습니다:

• 복잡한 3D 장면 생성
• 객체 모델링 및 조작
• 재질(머티리얼) 적용 및 관리
• Python 코드 자동 실행
• Poly Haven 자산 통합
• Hyper3D AI 생성 모델 활용

기술적으로는 블렌더 애드온(addon.py)과 MCP 서버(src/blender_mcp/server.py)로 구성되어 있으며, JSON 기반 프로토콜을 통해 TCP 소켓으로 통신합니다.

설치 준비사항

블렌더-mcp를 설치하기 전에 다음 항목들이 준비되어 있어야 합니다:

• Blender 3.0 이상 버전
• Python 3.10 이상 버전
• uv 패키지 매니저

설치 방법

1. uv 패키지 매니저 설치

Mac 사용자:

brew install uv

Windows 사용자:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Windows 사용자 에러발생할 경우:

에러는 PowerShell의 실행 정책이 스크립트를 실행할 수 없도록 설정되어 있기 때문에 발생하는 것입니다. 이를 해결하려면 아래 단계를 따라 실행 정책을 적절히 변경해 주세요:

1. **PowerShell을 관리자 권한으로 실행**  
   먼저 PowerShell을 관리자 권한으로 실행해야 합니다. 검색창에서 "PowerShell"을 입력하고, 프로그램 아이콘을 우클릭한 뒤 "관리자 권한으로 실행"을 선택합니다.

2. **실행 정책 변경**  
   다음 명령을 입력하여 실행 정책을 `RemoteSigned`로 변경합니다:  
   ```powershell
   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   ```

3. **변경 사항 확인**  
   실행 정책이 제대로 변경되었는지 확인하려면 다음 명령을 입력합니다:  
   ```powershell
   Get-ExecutionPolicy -Scope CurrentUser
   ```

   출력이 `RemoteSigned`라면 설정이 성공적으로 변경된 것입니다.

4. **스크립트 실행**  
   이제 다시 명령을 실행해 보세요:  
   ```powershell
   irm https://astral.sh/uv/install.ps1 | iex
   ```

실행 정책을 변경한 뒤에는, 보안을 위해 원래 실행 정책으로 되돌려 놓는 것이 좋습니다. 예를 들어, 명령을 완료한 후 다음을 실행하여 실행 정책을 원래 상태로 복구할 수 있습니다:  
```powershell
Set-ExecutionPolicy Restricted -Scope CurrentUser
```
이 방법으로 에러를 해결할 수 있을 거예요. 혹시 다른 문제가 있다면 말씀해 주세요!

설치 후 경로를 추가하세요:

set Path=C:\Users\[사용자이름]\.local\bin;%Path%

설치 후 경로를 추가 (영구적으로 설정하기)

임시 설정이 아닌 영구적으로 추가하려면 시스템 환경 변수를 수정해야 합니다. 다음 과정을 따라 진행하세요:

Windows GUI를 사용해 설정:

1. "내 PC" 또는 "내 컴퓨터"에서 속성을 클릭합니다.
2. 고급 시스템 설정을 클릭하고, 환경 변수 버튼을 선택합니다.
3. "사용자 변수" 또는 "시스템 변수" 섹션에서 Path를 찾아 편집을 클릭합니다.
4. 새 항목으로 C:\Users\pjpsc\.local\bin을 추가하고 확인을 누릅니다.
5. 환경 변수를 수정한 뒤 컴퓨터를 재부팅하거나 셸을 재시작해야 반영됩니다.

💡 더 자세한 uv 설치 방법은 uv 공식 설치 가이드를 참조하세요.

2. Claude for Desktop 설정하기

claude_desktop_config.json 파일을 다음과 같이 편집하세요:

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

📺 클로드 데스크톱 설정 영상 가이드를 참고하면 더욱 쉽게 설정할 수 있습니다.

3. Cursor 통합 설정 (선택사항)

터미널에서 다음 명령어를 실행하세요:

uvx blender-mcp

⚠️ 주의: Claude Desktop과 Cursor 중 하나만 실행해야 합니다. 둘 다 동시에 실행하지 마세요.

📺 Cursor 설정 영상 가이드를 통해 자세한 설정 방법을 확인하세요.

4. 블렌더 애드온 설치

1. blender-mcp GitHub 저장소에서 addon.py 파일을 다운로드합니다.
2. 블렌더를 실행하고 Edit > Preferences > Add-ons로 이동합니다.
3. Install... 버튼을 클릭하고 다운로드한 addon.py 파일을 선택합니다.
4. 목록에서 "Interface: Blender MCP" 애드온을 찾아 체크박스를 클릭하여 활성화합니다.

사용 방법

연결 시작하기

1. 블렌더를 실행하고 3D 뷰 모드로 전환합니다.
2. 키보드의 N 키를 눌러 사이드바를 엽니다.
3. 사이드바에서 "BlenderMCP" 탭을 선택합니다.
4. (선택사항) Poly Haven 자산을 사용하려면 해당 체크박스를 활성화합니다.
5. "Connect to Claude" 버튼을 클릭합니다.

⚠️ 중요: 연결하기 전에 터미널에서 MCP 서버가 실행 중인지 확인하세요(uvx blender-mcp 명령어 실행).

Claude와 상호작용하기

연결이 성공하면 블렌더 화면에 망치 아이콘이 표시됩니다. 이제 다음과 같은 작업을 수행할 수 있습니다:

• 장면 생성: "숲 속 오두막 장면을 만들어줘"
• 객체 조작: "큐브를 두 배로 키우고 빨간색으로 바꿔줘"
• 재질 적용: "이 오브젝트에 금속 재질을 적용해줘"
• Python 코드 실행: "모든 객체를 원점으로 이동하는 코드를 실행해줘"
• Poly Haven 자산 활용: "Poly Haven에서 바위와 나무를 가져와 배치해줘"
• Hyper3D 모델 활용: "Hyper3D로 현실적인 인물 모델을 생성해줘"

명령어 예시 및 데모

실제 사용 사례를 보려면 다음 데모 영상을 참고하세요:

• 던전 장면 생성 데모: "던전 장면에 저다각형 드래곤과 금 주전자 생성"
• 해변 분위기 생성 데모: "HDRIs, 텍스처, Poly Haven의 바위와 식물로 해변 분위기 생성"

Hyper3D 활용하기

Hyper3D를 통해 AI로 생성된 고품질 3D 모델을 사용할 수 있습니다. 무료 체험 키는 hyper3d.ai와 fal.ai에서 얻을 수 있으며, 일일 사용량 제한이 있습니다(매일 리셋됨).

문제 해결 가이드

연결 문제

• 블렌더 애드온이 서버에 연결되지 않는 경우:
  • MCP 서버가 터미널에서 실행 중인지 확인 (uvx blender-mcp)
  • Claude에서 MCP 서버 설정이 올바른지 확인
  • uvx가 직접 터미널에서 실행되고 있지 않은지 확인
  • 첫 번째 명령이 실패할 수 있으니 두 번 시도해보기

타임아웃 오류

복잡한 요청에서 타임아웃이 발생할 경우:

• 요청을 단순화해보세요
• 여러 단계로 나누어 명령을 내려보세요

Poly Haven 통합 문제

Poly Haven 자산 통합 시 Claude의 동작이 불규칙할 수 있습니다:

• 다양한 방식으로 명령을 다시 시도해보세요
• 좀 더 구체적인 자산 이름을 지정해보세요

일반적인 해결책

문제가 지속될 경우:

• Claude와의 연결을 재시작해보세요
• 블렌더 서버를 재시작해보세요

보안 고려사항

Python 코드 실행 관련 주의사항

블렌더-mcp의 execute_blender_code 기능은 임의의 Python 코드를 실행할 수 있어 보안상 위험이 있습니다:

• 신뢰할 수 있는 환경에서만 사용하세요
• 생산 환경에서는 특별한 주의가 필요합니다
• 중요한 작업 전에는 항상 작업을 저장하세요

Poly Haven 통합 제한

Poly Haven 통합은 외부 자산을 다운로드해야 합니다:

• 필요하지 않은 경우 애드온 설정에서 비활성화할 수 있습니다
• 네트워크 보안 정책에 따라 사용이 제한될 수 있습니다

활용 사례

블렌더-mcp는 다양한 3D 작업 시나리오에서 효율성을 크게 높일 수 있습니다:

빠른 프로토타이핑

복잡한 장면을 자연어 명령으로 빠르게 구성할 수 있어 아이디어를 신속하게 시각화할 수 있습니다.

학습 보조 도구

블렌더 초보자가 복잡한 명령어나 워크플로우 없이도 원하는 결과물을 만들 수 있습니다.

전문가 생산성 향상

반복적인 작업을 자동화하고, 복잡한 장면 구성을 단순화하여 전문가의 작업 속도를 높일 수 있습니다.

블렌더-mcp 구성 요소 및 기능

구성 요소 설명

Blender Addon (addon.py)	블렌더에 통합되어 AI 기능을 제공하는 인터페이스
MCP Server (src/blender_mcp/server.py)	Claude와 통신하며 JSON 기반 TCP 소켓 사용
명령 처리 모듈	자연어 명령을 블렌더 작업으로 변환
자산 통합 시스템	Poly Haven, Hyper3D 등 외부 자산 통합

결론

블렌더-mcp는 AI의 힘을 활용하여 3D 창작 과정을 혁신적으로 변화시키는 강력한 도구입니다. 이 가이드를 따라 설치하고 활용한다면, 복잡한 3D 모델링 작업을 자연어 명령만으로 수행하는 새로운 경험을 할 수 있을 것입니다. 보안 주의사항을 준수하면서 창의적인 3D 작업에 블렌더-mcp를 활용해보세요!

더 많은 정보와 최신 업데이트는 blender-mcp GitHub 저장소를 참조하시기 바랍니다.