mcp-for-blender-pro란?
mcp-for-blender-pro는 AI 모델을 Blender에 연결하는 Blender 확장 기능이자 보조 작업 공간입니다. 씬을 검사하고, 오브젝트를 만들고 편집하며, 머티리얼을 할당하고, 뷰포트 스크린샷을 캡처하고, 에셋을 검색하고 가져오며, Blender API를 참조하고, 씬을 내보낼 수 있습니다.
이 프로젝트는 대화형 지원, 모델 선택, 씬 도구, 승인, 에이전트 워크플로를 하나의 작업 공간에 통합합니다. Blender에서 결과를 계속 검토하면서 반복적인 작업을 자동화하려는 아티스트, 테크니컬 아티스트, 개발자를 위해 설계되었습니다.
주요 기능
- Blender 인식 지원: 작업을 수행하기 전에 씬과 오브젝트 정보를 검사할 수 있습니다.
- Visual Studio 작업 공간: 보조 창에서 채팅, 씬 오브젝트, 뷰포트 스냅샷, 승인, 작업 보드를 사용할 수 있습니다.
- 다양한 AI 연결: 지원되는 OpenAI, Anthropic Claude, Google Gemini, OpenRouter, OpenCode Zen, Ollama 또는 사용자 지정 API 연결을 사용할 수 있습니다.
- 저장된 연결: 하나의 제공업체에 여러 키를 포함하여 업무용과 개인용 연결을 별도로 저장할 수 있습니다.
- 단일 어시스턴트 또는 팀 워크플로: 직접 변경에는 하나의 모델을 사용하고, 구조화된 작업에는 관리자, 작업자, 검토자를 구성할 수 있습니다.
- 내장 MCP 서버: 인증된 Streamable HTTP MCP를 지원하는 OpenCode 및 기타 클라이언트를 연결할 수 있습니다.
- 씬 도구: 검사, 오브젝트 생성, 편집, 시각적 피드백, Blender API 조회, 내보내기, 에셋 워크플로를 위한 도구가 포함되어 있습니다.
- 다국어 메뉴: 기본 인터페이스는 영어, 독일어, 프랑스어, 스페인어, 중국어를 지원합니다.
요구 사항 및 설치
릴리스 번들은 Windows x64를 대상으로 하며 Blender 4.2 이상이 필요합니다. GitHub Releases 페이지에서 최신 mcp-for-blender-pro.zip 패키지를 다운로드하세요.
- Blender를 열고 Edit → Preferences를 선택합니다.
- Get Extensions를 열고, 환경 설정 메뉴를 연 다음 Install from Disk를 선택합니다.
- 다운로드한 ZIP 파일을 선택합니다.
mcp-for-blender-pro를 활성화합니다.N을 눌러 3D Viewport 사이드바를 연 다음 MCP Pro 패널을 선택합니다.
Studio 창이나 외부 MCP 클라이언트를 사용하는 동안 Blender를 열어 두세요. 저장소의 자세한 설정 정보는 빠른 시작 가이드를 참조하세요.
AI 모델 연결
확장 기능을 활성화한 후 MCP Pro 패널에서 제공업체를 선택하고 필요한 연결 정보를 입력한 다음 모델을 선택합니다. 이제 Blender에서 직접 메시지를 보내거나 Open Studio Window를 클릭해 시각적 작업 공간을 사용할 수 있습니다.
지원되는 사용자 지정 엔드포인트는 다음 프로토콜 중 하나를 사용합니다.
- OpenAI Chat Completions
- Anthropic Messages
- Ollama
씬 작업을 위해 도구 호출을 지원하는 모델을 선택하세요. 이미지 처리 기능이 있는 모델은 뷰포트 스크린샷도 해석할 수 있습니다. OpenCode 전용 무료 모델은 OpenCode 클라이언트를 통해 사용할 수 있습니다.
기본 Blender 작업에 어시스턴트 사용
먼저 현재 씬을 검사하도록 요청하세요. 이렇게 하면 모델이 변경을 수행하기 전에 씬을 이해했는지 확인할 수 있습니다.
변경하기 전에 이 씬을 검사하고 오브젝트 구조를 설명해 주세요.
그런 다음 일반 언어로 씬 작업 순서를 요청할 수 있습니다. 예를 들어 어시스턴트는 받침대, 카메라, 조명이 있는 간단한 제품 디스플레이를 만든 다음 머티리얼을 할당할 수 있습니다.
받침대, 카메라, 조명 3개가 있는 간단한 제품 디스플레이 씬을 만들어 주세요. 받침대에 무광 파란색 머티리얼을 적용해 주세요.
선택한 오브젝트를 복제하고 결과를 뷰포트에 표시하도록 요청할 수도 있습니다.
선택한 오브젝트를 일정한 간격으로 5개가 되도록 깔끔한 행으로 복제하고 뷰포트에 표시해 주세요.
대화 방식으로 에셋 워크플로도 수행할 수 있습니다. 어시스턴트에게 에셋을 검색하고 가져오기 전에 승인을 요청하도록 하세요.
이 씬에 적합한 Poly Haven 에셋을 찾고, 가져오기 전에 승인을 요청해 주세요.
사용 가능한 씬 도구 이해
내장 MCP 서버는 일반적인 Blender 작업을 중심으로 그룹화된 도구를 제공합니다:
- 장면 검사:
get_scene_info,list_objects,get_object_info. - 오브젝트 생성:
add_cube,add_sphere,add_cylinder,add_plane,add_light,add_camera. - 편집:
move_object,duplicate_object,delete_object,parent_objects,set_material. - 시각적 피드백 및 스크립팅:
viewport_screenshot,execute_code. - Blender API 및 내보내기:
bpy_api_lookup,describe_node_type,export_scene. - 에셋 워크플로:
search_assets,import_asset.
에셋 통합 기능에는 Poly Haven, Sketchfab, Poly Pizza가 포함됩니다. 필요한 경우 서비스 키를 구성하고, 사용하는 모든 에셋의 라이선스 약관을 준수하세요.
팀 워크플로 구축
간단한 편집에는 단일 어시스턴트를 선택하세요. 더 큰 요청에는 다양한 모델이나 역할이 계획 수립, 장면 작업, 검토를 담당하는 팀 체인을 사용할 수 있습니다.
- 관리자: 요청을 작업 단위로 나누고 승인 기준을 정의합니다.
- 작업자: 할당된 장면 작업을 수행합니다.
- 검토자: 결과를 확인하고 작업을 승인하거나 구체적인 발견 사항을 전달합니다.
장면 편집 순서를 유지할 수 있도록 작업은 순차적으로 실행됩니다. 작업이 차단되면 한 번의 수정 기회가 주어집니다. 두 번째 검토 실패가 발생하면 워크플로가 중지됩니다. 작업 보드에는 진행 중인 할당, 시도 횟수, 검토 결과가 표시됩니다.
외부 MCP 클라이언트 연결
사이드바에서 OpenCode Portable을 실행하면 Blender 연결이 구성된 상태로 OpenCode를 사용할 수 있습니다. OpenCode가 자체 공급자 로그인과 모델 선택을 관리합니다.
호환되는 다른 MCP 클라이언트는 프로젝트의 연결 및 에이전트 가이드에 설명된 인증된 로컬 엔드포인트에 연결할 수 있습니다. 내장 서버는 인증된 Streamable HTTP MCP를 사용하므로 외부 클라이언트를 구성하기 전에 연결 지침을 검토하세요.
고급 사용법 및 안전 팁
변경 전에 검사 사용
신뢰할 수 있는 결과를 얻으려면 변경을 요청하기 전에 어시스턴트에게 장면이나 선택한 오브젝트를 검사하도록 요청하세요. 이를 통해 현재 오브젝트 구조를 파악하고 여러 단계로 구성된 프롬프트의 모호성을 줄일 수 있습니다.
시각적 검증 요청
작업으로 레이아웃, 재질 또는 조명이 변경되는 경우 뷰포트 스크린샷을 요청하세요. 이미지 인식이 가능한 모델은 이러한 스크린샷을 해석할 수 있으며, Studio 미리보기를 사용해 결과를 검토할 수 있습니다.
민감한 작업에 승인 사용
내장 채팅은 작업 승인, 현재 단계 이후 취소, 변경 작업을 위한 이름이 지정된 실행 취소 단계를 지원합니다. 장면이 변경되기 전에 작업을 검토하려면 이러한 컨트롤을 사용하세요.
Python 검증 이해
Python 도구 검증은 허용되지 않은 작업을 감지하는 데 도움이 될 수 있지만, 보안 샌드박스가 아닙니다. 생성된 스크립트와 장면 변경을 검토가 필요한 작업으로 취급하세요. 외부 MCP 클라이언트는 자체 승인 정책을 관리합니다.
자격 증명 및 세션 유의
연결 자격 증명은 사용자 설정에 저장됩니다. 채팅 기록은 현재 세션 동안 유지되며, Studio는 Blender에 대한 요청을 인증하면서 로컬에서 실행됩니다.
결론
mcp-for-blender-pro는 Blender 사용자가 대화 방식으로 장면을 검사하고, 오브젝트를 생성 및 편집하고, 재질을 관리하고, 에셋을 활용하고, 내보내기를 자동화할 수 있도록 지원합니다. Blender 4.2 이상에 확장 기능을 설치하고, 도구를 사용할 수 있는 모델을 연결한 다음, 검사 프롬프트부터 시작하세요. 워크플로가 복잡해지면 Studio, MCP 클라이언트 또는 검토를 거치는 에이전트 팀으로 확장할 수 있습니다.
이 프로젝트는 MIT 라이선스로 배포됩니다. OpenCode의 라이선스는 배포판에 포함되어 있으며, 이 프로젝트는 Blender 재단 및 명시된 AI 공급자와 독립적입니다.