mcp-for-blender-pro란 무엇인가요?
mcp-for-blender-pro는 Blender용 AI 어시스턴트이자 Model Context Protocol 서버입니다. AI 모델이 현재 장면을 검사하고, 오브젝트를 생성 및 편집하고, 머티리얼을 할당하고, 에셋을 검색하고, 뷰포트 이미지를 캡처하고, 지원되는 워크플로를 실행하고, 장면을 내보낼 수 있도록 합니다.
이 확장 기능은 Blender를 인식하는 도구와 시각적 Studio 작업 공간을 결합합니다. 채팅으로 작업을 논의하고, 어시스턴트의 작업을 확인하고, 뷰포트 스냅샷을 검토하고, 작업을 승인하며, 워크플로가 실행되는 동안 Blender에서 계속 작업할 수 있습니다.
이 프로젝트는 더 빠른 반복 작업을 원하는 아티스트, 반복 작업을 자동화하는 테크니컬 아티스트, MCP 호환 AI 도구를 Blender에 연결하려는 개발자를 위한 것입니다.
주요 기능
- 장면 인식 지원: 어시스턴트가 변경하기 전에 장면을 검사하고, 오브젝트를 나열하고, 오브젝트 세부 정보를 가져올 수 있습니다.
- 시각적 Studio 작업 공간: 전용 창에서 채팅, 장면 오브젝트, 뷰포트 스냅샷, 승인 및 작업 보드를 제공합니다.
- 다양한 AI 공급자: OpenAI, Anthropic Claude, Google Gemini, OpenRouter, OpenCode Zen, Ollama 및 호환되는 사용자 지정 API 연결을 지원합니다.
- 저장된 연결: 업무용 및 개인용 구성을 분리하거나 동일한 공급자에 여러 키를 저장할 수 있습니다.
- 단일 에이전트 및 다중 에이전트 모드: 직접 편집에는 하나의 어시스턴트를 사용하고, 체계적인 워크플로에는 관리자, 작업자 및 검토자를 구성할 수 있습니다.
- 내장 MCP 서버: 인증된 Streamable HTTP MCP를 지원하는 OpenCode 및 기타 클라이언트를 연결할 수 있습니다.
- 21개의 장면 도구: 장면을 검사, 생성, 편집 및 캡처하고, 스크립트를 실행하고, 에셋을 검색하고, Blender API를 참조하고, 장면을 내보낼 수 있습니다.
- 다국어 인터페이스: 기본 메뉴는 영어, 독일어, 프랑스어, 스페인어 및 중국어를 지원합니다.
요구 사항 및 설치
릴리스 번들은 Windows x64를 대상으로 하며 Blender 4.2 이상이 필요합니다. 설치하기 전에 패키지로 제공된 확장 기능을 압축 해제하지 말고 다운로드하세요.
- 최신 릴리스에서
mcp-for-blender-pro.zip을 다운로드합니다. - Blender를 시작하고 Edit → Preferences를 엽니다.
- Get Extensions를 선택하고 메뉴를 연 다음 Install from Disk를 선택합니다.
- 다운로드한 ZIP 아카이브를 선택합니다.
- Blender가 설치를 완료하면 mcp-for-blender-pro를 활성화합니다.
- 3D Viewport로 돌아가
N을 눌러 사이드바를 연 다음 MCP Pro를 선택합니다.
Studio 창을 사용하거나 외부 MCP 클라이언트를 연결할 때는 Blender를 계속 실행해 두세요. Blender가 활성 장면을 제공하고 요청된 장면 작업을 실행합니다.
AI 모델 연결
요청을 보내기 전에 지시를 해석하고 Blender 도구를 호출할 모델을 구성합니다.
- Blender에서 MCP Pro 패널을 엽니다.
- 지원되는 공급자를 선택합니다.
- 공급자 자격 증명 또는 엔드포인트 설정과 같은 필수 연결 정보를 입력합니다.
- 사용 가능한 모델 카탈로그를 불러옵니다.
- 모델을 선택하고 재사용하려면 연결을 저장합니다.
- Blender에서 직접 메시지를 보내거나 Open Studio Window를 클릭합니다.
도구 호출을 지원하는 모델을 선택하세요. 모델이 뷰포트 스크린샷을 해석하도록 하려면 이미지를 지원하는 모델을 선택합니다. 사용자 지정 엔드포인트는 OpenAI Chat Completions, Anthropic Messages 또는 Ollama 프로토콜을 사용할 수 있습니다. OpenCode 전용 무료 모델은 OpenCode 클라이언트를 통해 액세스합니다.
편집하기 전에 장면 검사
처음에는 어시스턴트에게 아무것도 변경하지 않고 장면을 검토하도록 요청하는 것이 좋습니다. 이렇게 하면 모델에 컨텍스트를 제공하고 오브젝트 계층 구조를 제대로 이해했는지 확인할 수 있습니다.
이 장면을 검사하고 변경하기 전에 오브젝트 구조를 설명해 줘.
검사를 위해 확장 기능은 get_scene_info, list_objects 및 get_object_info와 같은 도구를 사용할 수 있습니다. 그런 다음 보고된 오브젝트, 이름 및 관계를 바탕으로 요청을 구체화할 수 있습니다.
프롬프트로 장면 생성
검사가 끝나면 원하는 결과를 구체적으로 설명하세요. 필요한 오브젝트, 배치, 조명, 카메라 및 머티리얼 속성을 포함합니다.
받침대, 카메라 하나, 조명 세 개가 있는 간단한 제품 전시 장면을 만들어 줘. 받침대에는 무광 파란색 머티리얼을 적용해 줘.
어시스턴트는 큐브, 구, 실린더, 평면, 조명 및 카메라를 생성하는 도구를 호출할 수 있습니다. 그런 다음 move_object 및 set_material과 같은 편집 도구를 사용해 오브젝트를 배치하고 머티리얼을 적용할 수 있습니다.
예측 가능한 결과를 얻으려면 중요한 제약 조건을 명시하세요. 예를 들어 어떤 오브젝트를 선택된 상태로 유지할지, 기존 오브젝트를 이동해도 되는지, 변경을 완료한 후 어시스턴트가 뷰포트 스냅샷을 표시해야 하는지를 지정합니다.
기존 오브젝트 편집
반복적인 모델링 및 배치 작업에도 대화형 지시를 사용할 수 있습니다. Blender에서 관련 오브젝트를 선택하고 다음과 같이 구체적으로 요청하세요.
선택한 오브젝트를 일정한 간격으로 정렬된 다섯 개의 행으로 복제하고 뷰포트를 보여 줘.
관련 편집 도구는 다음과 같습니다.
- 객체 위치를 변경하는
move_object. - 복사본을 생성하는
duplicate_object. - 객체를 제거하는
delete_object. - 객체 관계를 생성하는
parent_objects. - 재질을 할당하는
set_material. - 시각적 피드백을 제공하는
viewport_screenshot.
생성된 뷰포트 스냅샷을 검토하고 간격, 구성 또는 재질을 조정해야 한다면 수정 프롬프트를 계속 입력하세요.
에셋 검색 및 가져오기
에셋 통합 기능에는 Poly Haven, Sketchfab, Poly Pizza가 포함됩니다. 소스에서 요구하는 경우 서비스 키를 구성하고, 각 에셋에 적용되는 라이선스를 항상 준수하세요.
가져오기 전에 결과를 검토할 수 있도록 검색과 가져오기를 분리하는 것이 좋습니다.
이 장면에 적합한 Poly Haven 에셋을 찾아 가져오기 전에 확인을 요청하세요.
어시스턴트는 search_assets를 사용해 후보를 찾고, 선택을 승인한 후 import_asset를 사용할 수 있습니다. 가져오기 전에 확인을 요청하면 원치 않는 다운로드와 장면 변경을 줄일 수 있습니다.
대규모 워크플로에 팀 사용
단일 어시스턴트 모드는 빠른 변경과 직접적인 대화에 적합합니다. 계획과 검토가 필요한 작업에는 팀 체인을 구성하세요.
팀에서는 세 가지 역할 유형에 서로 다른 책임과 모델을 할당할 수 있습니다.
- 관리자: 요청을 작업으로 나누고 승인 기준을 정의합니다.
- 작업자: 할당된 Blender 장면 작업을 수행합니다.
- 검토자: 완료된 작업을 검사하고 승인하거나 구체적인 결과를 전달합니다.
작업은 순차적으로 실행되므로 장면 수정 순서가 유지됩니다. 검토에서 작업이 차단되면 워크플로에서는 한 번의 수정 시도를 허용합니다. 두 번째 검토 실패 시 워크플로가 중지됩니다. 작업 보드에서 할당, 시도 횟수 및 검토 결과를 확인하세요.
팀 모드는 원래 요청에 측정 가능한 요구 사항이 포함되어 있을 때 가장 효과적입니다. 객체 수, 이름 지정 규칙, 배치 제약 조건, 재질 목표 및 검토자가 확인할 조건을 구체적으로 지정하세요.
외부 MCP 클라이언트 연결
이 확장 기능에는 Streamable HTTP를 사용하는 인증된 로컬 MCP 엔드포인트가 포함되어 있습니다. Blender 사이드바에서 OpenCode Portable을 실행하면 Blender 연결이 자동으로 구성된 OpenCode를 사용할 수 있습니다. OpenCode가 자체 공급자 로그인과 모델 선택을 처리합니다.
호환되는 다른 MCP 클라이언트는 프로젝트의 연결 가이드에 따라 로컬 엔드포인트에 연결할 수 있습니다. 세션 중에는 Blender를 계속 열어 두세요. 외부 클라이언트는 기본 제공 채팅의 승인 제어가 아닌 자체 승인 정책을 사용합니다.
사용 가능한 도구 그룹
기본 제공 도구는 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.
고급 워크플로 팁
먼저 검사하고, 다음에 변경하세요
중요한 작업은 장면 검사로 시작하세요. 편집을 요청하기 전에 어시스턴트에게 관련 객체 이름과 관계를 식별하도록 요청하세요. 이렇게 하면 이후 지시가 더 구체적이고 검토하기 쉬워집니다.
체크포인트 요청
여러 단계로 장면을 구축할 때는 작업을 단계로 나누고 중요한 변경 후 뷰포트 스냅샷을 요청하세요. 이미지 인식이 가능한 모델을 사용할 때 시각적 체크포인트가 특히 유용합니다.
명확한 승인 기준 사용
팀 워크플로에서는 주관적인 지시를 검토자가 평가할 수 있는 확인 항목으로 바꾸세요. 예를 들어 조명 수, 필수 카메라, 사용할 재질 및 정확한 객체 배치를 지정하세요.
필요할 때 Blender API 참조
어시스턴트는 bpy_api_lookup 및 describe_node_type을 사용해 Blender API와 노드 정보를 확인할 수 있습니다. execute_code 도구는 스크립팅 워크플로를 지원할 수 있지만, 생성된 작업은 여전히 신중하게 검토해야 합니다.
승인 및 실행 취소 제어 사용
기본 제공 채팅은 작업 승인, 현재 단계 이후 취소 및 변경 작업을 위한 이름이 지정된 실행 취소 단계를 지원합니다. 실험 중이거나 요청이 많은 객체를 변경할 수 있을 때 이러한 제어 기능을 사용하세요.
보안 경계 이해
Python 도구 검증은 허용되지 않는 작업을 감지하는 데 도움이 되지만 보안 샌드박스가 아닙니다. 승인하기 전에 요청된 작업과 코드를 검토하세요. 연결 자격 증명은 사용자 설정에 저장되고, Studio는 로컬에서 실행되며, Blender에 대한 요청은 인증됩니다.
세션 동작에 맞춰 계획
채팅 기록은 현재 세션 동안에만 유지됩니다. 나중에 재현해야 하는 중요한 프롬프트, 결정 또는 워크플로 지침은 다른 곳에 보관하세요.
결론
mcp-for-blender-pro는 AI 채팅, Blender 장면 도구, 모델 선택, 시각적 피드백, 에셋 검색, 다중 에이전트 워크플로를 하나의 작업 공간에 통합합니다. 먼저 확장 프로그램을 설치하고, 도구를 사용할 수 있는 모델을 연결한 다음, 간단한 장면을 살펴보세요. 기본 워크플로에 익숙해지면 승인, 뷰포트 체크포인트, 팀 역할, MCP 클라이언트를 활용해 더 큰 Blender 작업을 자동화하면서 장면 변경 사항을 검토 가능한 상태로 유지할 수 있습니다.