BlenderMCP - Blender 모델 컨텍스트 프로토콜 통합

BlenderMCP는 모델 컨텍스트 프로토콜(MCP)을 통해 Blender와 Claude AI를 연결하여 Claude가 Blender와 직접 상호 작용하고 제어할 수 있도록 합니다. 이러한 통합을 통해 3D 모델링, 장면 생성 및 조작을 신속하게 지원할 수 있습니다.

전체 튜토리얼

커뮤니티에 가입하세요

피드백을 제공하고, 영감을 얻고, MCP를 기반으로 구축하세요: Discord

지지자들

주요 지지자:

코드래빗

모든 지지자:

이 프로젝트를 지원하세요

릴리스 노트(1.1.0)

• API를 통해 Poly Haven 자산에 대한 지원이 추가되었습니다.
• Hyper3D Rodin을 사용하여 3D 모델을 신속하게 생성할 수 있는 지원이 추가되었습니다.
• 신규 사용자는 바로 설치 페이지로 이동하실 수 있습니다. 기존 사용자는 아래 내용을 참조하세요.
• 최신 addon.py 파일을 다운로드하고 이전 파일을 교체한 다음 Blender에 추가하세요.
• Claude에서 MCP 서버를 삭제했다가 다시 추가하면 문제없이 사용할 수 있습니다!

특징

• 양방향 통신 : 소켓 기반 서버를 통해 Claude AI를 Blender에 연결합니다.
• 객체 조작 : Blender에서 3D 객체를 생성, 수정 및 삭제합니다.
• 재료 관리 : 재료 및 색상 적용 및 수정
• 장면 검사 : 현재 Blender 장면에 대한 자세한 정보를 얻으세요
• 코드 실행 : Claude의 Blender에서 임의의 Python 코드 실행

구성 요소

이 시스템은 두 가지 주요 구성 요소로 구성됩니다.

1. Blender 애드온( addon.py ) : Blender 내에서 소켓 서버를 생성하여 명령을 수신하고 실행하는 Blender 애드온
2. MCP 서버( src/blender_mcp/server.py ) : 모델 컨텍스트 프로토콜을 구현하고 Blender 애드온에 연결하는 Python 서버

설치

필수 조건

• 블렌더 3.0 이상
• Python 3.10 이상
• uv 패키지 관리자:

Mac을 사용 중이라면 uv를 설치하세요.

지엑스피1

윈도우에서

그런 다음

그렇지 않은 경우 설치 지침은 해당 웹사이트에 있습니다: uv 설치

⚠️ UV 설치 전 진행하지 마세요

데스크톱 통합을 위한 Claude

설치 지침 비디오를 시청하세요 (이미 uv를 설치했다고 가정)

Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json으로 이동하여 다음을 포함합니다.

커서 통합

Mac 사용자의 경우 설정 > MCP로 이동하여 다음을 붙여넣습니다.

• 글로벌 서버로 사용하려면 "새로운 글로벌 MCP 서버 추가" 버튼을 사용하여 붙여넣으세요.
• 프로젝트별 서버로 사용하려면 프로젝트 루트에 .cursor/mcp.json 만들고 붙여넣으세요.

Windows 사용자의 경우 설정 > MCP > 서버 추가로 이동하여 다음 설정으로 새 서버를 추가하세요.

커서 설정 비디오

⚠️ MCP 서버 인스턴스를 하나만 실행하세요(Cursor 또는 Claude Desktop에서 실행). 둘 다 실행하지 마세요.

블렌더 애드온 설치

1. 이 저장소에서 addon.py 파일을 다운로드하세요
2. 블렌더 열기
3. 편집 > 기본 설정 > 추가 기능으로 이동하세요.
4. "설치..."를 클릭하고 addon.py 파일을 선택하세요
5. "인터페이스: Blender MCP" 옆의 상자를 체크하여 애드온을 활성화하세요.

용법

연결 시작

1. Blender에서 3D 보기 사이드바로 이동합니다(표시되지 않으면 N을 누르세요)
2. "BlenderMCP" 탭을 찾으세요
3. API에서 자산을 가져오려면 Poly Haven 체크박스를 켜세요(선택 사항)
4. "Claude에게 연결"을 클릭하세요
5. 터미널에서 MCP 서버가 실행 중인지 확인하세요.

Claude와 함께 사용

Claude에서 구성 파일을 설정하고 Blender에서 애드온을 실행하면 Blender MCP에 대한 도구가 있는 망치 아이콘이 표시됩니다.

역량

• 장면 및 객체 정보 가져오기
• 모양 만들기, 삭제 및 수정
• 객체에 대한 재료를 적용하거나 생성합니다.
• Blender에서 모든 Python 코드 실행
• Poly Haven을 통해 올바른 모델, 자산 및 HDRI를 다운로드하세요.
• Hyper3D Rodin을 통해 AI가 생성한 3D 모델

예제 명령

클로드에게 요청할 수 있는 작업의 몇 가지 예는 다음과 같습니다.

• "던전에서 금화 항아리를 지키는 용이 있는 로우 폴리 장면을 만들어 보세요" 데모
• "Poly Haven의 바위와 식물과 같은 HDRI, 텍스처 및 모델을 사용하여 해변 분위기를 만들어 보세요" 데모
• 참조 이미지를 제공하고 이를 기반으로 Blender 장면을 만들어 보세요. 데모
• "Hyper3D를 통해 정원 난쟁이의 3D 모델을 생성하세요"
• "현재 장면에 대한 정보를 얻고 이를 바탕으로 Three.js 스케치를 만듭니다" 데모
• "이 차를 빨간색과 금속색으로 만들어라"
• "구체를 만들어 큐브 위에 놓으세요"
• "조명을 스튜디오처럼 만들어라"
• "카메라를 현장으로 향하게 하고 등각 투영으로 만들어라"

Hyper3D 통합

Hyper3D 무료 체험판을 사용하면 하루에 제한된 수의 모델을 생성할 수 있습니다. 일일 한도에 도달하면 다음 날 초기화될 때까지 기다리거나 hyper3d.ai 및 fal.ai에서 직접 체험판을 받으실 수 있습니다.

문제 해결

• 연결 문제 : 블렌더 애드온 서버가 실행 중이고 Claude에 MCP 서버가 구성되어 있는지 확인하세요. 터미널에서 uvx 명령을 실행하지 마세요. 가끔 첫 번째 명령은 실행되지 않지만, 그 후부터는 작동하기 시작합니다.
• 시간 초과 오류 : 요청을 단순화하거나 더 작은 단계로 나누어보세요.
• Poly Haven 통합 : Claude는 때때로 동작이 불규칙합니다.
• 전원을 껐다가 다시 켜보셨나요? : 여전히 연결 오류가 발생하는 경우 Claude와 Blender 서버를 다시 시작해 보세요.

기술적 세부 사항

통신 프로토콜

이 시스템은 TCP 소켓을 통한 간단한 JSON 기반 프로토콜을 사용합니다.

• 명령은 type 과 선택적 params 포함하는 JSON 객체로 전송됩니다.
• 응답은 status 와 result 또는 message 포함하는 JSON 객체입니다.

제한 사항 및 보안 고려 사항

• execute_blender_code 도구를 사용하면 Blender에서 임의의 Python 코드를 실행할 수 있습니다. 이 기능은 강력하지만 잠재적으로 위험할 수 있습니다. 프로덕션 환경에서는 주의해서 사용해야 합니다. 사용하기 전에 항상 작업 내용을 저장하세요.
• Poly Haven을 사용하려면 모델, 텍스처, HDRI 이미지를 다운로드해야 합니다. 사용하지 않으려면 Blender의 체크박스에서 해당 기능을 해제하세요.
• 복잡한 작업은 더 작은 단계로 나누어야 할 수도 있습니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

부인 성명

이 기능은 Blender에서 만든 것이 아닌 타사 통합 기능입니다. Siddharth 에서 제작했습니다.