mcp-for-blender-pro는 Blender를 AI 어시스턴트, 모델 제공업체, Model Context Protocol(MCP) 클라이언트와 하나의 창작 작업 공간에서 연결합니다. 장면을 검사하고, 오브젝트를 생성 및 편집하고, 재질을 할당하고, 에셋을 검색하고, 뷰포트 미리보기를 캡처하고, Blender API를 참조하고, 장면을 내보낼 수 있습니다.
이 튜토리얼에서는 확장 기능 설치, AI 연결 구성, 유용한 프롬프트 전송 방법과 에이전트 팀 또는 외부 MCP 클라이언트를 활용해 작업 흐름을 확장하는 방법을 설명합니다.
mcp-for-blender-pro의 기능
이 프로젝트는 Blender에 AI 어시스턴트를 추가하고, 시각적 Studio 작업 공간을 함께 제공합니다. 자연어로 창작 또는 기술 작업을 설명하면 어시스턴트가 Blender를 인식하는 도구를 사용해 현재 장면을 검사하고 승인된 작업을 수행합니다.
이 확장 기능은 더 빠른 반복 작업을 원하는 아티스트, 반복 작업을 자동화하는 테크니컬 아티스트, MCP를 통해 AI 도구를 Blender에 연결하는 개발자를 위해 설계되었습니다.
주요 기능
- 장면 인식 지원: 변경하기 전에 장면과 오브젝트를 검사합니다.
- 시각적 Studio 작업 공간: 채팅, 장면 오브젝트, 뷰포트 스냅샷, 승인, 작업 보드를 한곳에서 관리합니다.
- 다중 AI 연결: OpenAI, Anthropic Claude, Google Gemini, OpenRouter, OpenCode Zen, Ollama 또는 호환되는 사용자 지정 API를 사용할 수 있습니다.
- 저장된 연결: 업무용 구성과 개인용 구성을 분리하고, 동일한 제공업체에 여러 키를 저장할 수 있습니다.
- 에이전트 작업 흐름: 단일 어시스턴트를 사용하거나 대규모 작업을 위해 관리자, 작업자, 검토자를 구성할 수 있습니다.
- 내장 MCP 서버: 인증된 Streamable HTTP MCP를 지원하는 OpenCode 및 기타 클라이언트를 연결합니다.
- 장면 도구: 장면을 생성, 검사, 편집, 캡처하고, 에셋을 검색하고, Blender API를 참조하고, 장면을 내보낼 수 있습니다.
- 다국어 인터페이스: 기본 인터페이스에서 영어, 독일어, 프랑스어, 스페인어 또는 중국어를 선택할 수 있습니다.
사전 요구 사항 및 설치
릴리스 번들은 Windows x64를 대상으로 하며 Blender 4.2 이상이 필요합니다. 시작하기 전에 최신 mcp-for-blender-pro 릴리스를 다운로드하세요.
- Releases 페이지에서
mcp-for-blender-pro.zip을 다운로드합니다. - Blender를 열고 Edit → Preferences → Get Extensions로 이동합니다.
- 확장 기능 메뉴를 열고 Install from Disk를 선택합니다.
- 다운로드한 ZIP 파일을 선택합니다.
mcp-for-blender-pro를 활성화합니다.- 3D Viewport에서
N을 눌러 사이드바를 열고 MCP Pro를 선택합니다.
Studio 창 또는 외부 MCP 클라이언트를 사용하는 동안 Blender를 계속 열어 두세요. 애드온은 로컬에서 실행되며 Blender에 대한 요청을 인증합니다.
모델 연결 구성
확장 기능을 활성화한 후 MCP Pro 패널에서 제공업체를 선택하고 필요한 연결 정보를 입력한 다음 모델을 선택합니다. 사용 가능한 모델 카탈로그를 불러와 Blender 또는 Studio에서 직접 모델을 선택할 수 있습니다.
지원되는 사용자 지정 엔드포인트는 OpenAI Chat Completions, Anthropic Messages 또는 Ollama 프로토콜을 사용할 수 있습니다. 도구 호출을 지원하는 모델을 선택하세요. 이미지 처리 기능이 있는 모델은 뷰포트 스크린샷도 해석할 수 있습니다.
로컬 추론을 사용하려면 Ollama 모델에 연결하세요. 호스팅 서비스를 사용하려면 지원되는 클라우드 제공업체 중 하나를 구성하세요. OpenCode 전용 무료 모델은 OpenCode 클라이언트를 통해 사용할 수 있습니다.
연결 자격 증명은 사용자 설정에 저장됩니다. 채팅 기록은 현재 세션 동안만 유지되므로 장기적으로 보관해야 하는 중요한 지침이나 결과는 다른 곳에 저장하세요.
기본적인 Blender 작업에 어시스턴트 사용
연결과 모델을 선택한 후 Blender에서 메시지를 보내거나 Open Studio Window를 클릭해 시각적 작업 공간에서 작업하세요. 수정하기 전에 어시스턴트가 현재 장면을 이해할 수 있도록 검사 요청부터 시작하세요.
이 장면을 검사하고 변경하기 전에 오브젝트 구조를 설명해 주세요.
장면을 이해했다면 어시스턴트에게 간단한 구성을 만들어 달라고 요청하세요. 예를 들면 다음과 같습니다.
받침대, 카메라 1대, 조명 3개가 있는 간단한 제품 전시 장면을 만들어 주세요. 받침대에는 무광 파란색 재질을 적용해 주세요.
반복적인 오브젝트 작업과 시각적 피드백도 요청할 수 있습니다.
선택한 오브젝트를 간격이 고르게 유지되는 5개 행으로 복제하고 뷰포트를 보여 주세요.
외부 에셋을 사용할 때는 어시스턴트에게 적합한 에셋을 찾아 달라고 요청하고, 가져오기 전에 승인을 요청하도록 하세요.
이 장면에 적합한 Poly Haven 에셋을 찾아 가져오기 전에 확인을 요청해 주세요.
변경 사항 검토 및 제어
내장 채팅은 작업 승인, 현재 단계가 끝난 후 취소, 변경 작업을 위한 이름이 지정된 실행 취소 단계를 지원합니다. 특히 요청이 여러 오브젝트나 재질에 영향을 미치는 경우, 변경 사항을 승인하기 전에 제안된 작업을 검토하고 뷰포트를 확인하세요.
Python 도구 검증은 허용되지 않은 작업을 찾아내는 데 도움이 될 수 있지만, 보안 샌드박스는 아닙니다. 외부 MCP 클라이언트는 자체 승인 정책을 관리합니다.
사용 가능한 씬 도구 이해하기
mcp-for-blender-pro는 용도별로 그룹화된 21개의 씬 도구를 제공합니다. 어시스턴트는 요청을 처리하는 동안 이러한 도구를 선택해 사용할 수 있습니다.
- 씬 검사:
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.
이러한 도구를 사용하면 하나의 대화에서 씬 검사, 씬 편집, 시각적 확인, 스크립팅, 에셋 검색 및 내보내기를 조합할 수 있습니다.
멀티 에이전트 워크플로 구축하기
직접 대화로 변경하려면 단일 어시스턴트를 사용하세요. 규모가 큰 프로젝트에서는 서로 다른 역할, 지침 및 모델을 지정한 팀 체인을 구성할 수 있습니다.
- 관리자: 요청을 작업과 승인 기준으로 나눕니다.
- 작업자: 할당된 씬 작업을 수행합니다.
- 검토자: 결과를 검사하고 작업을 승인하거나 구체적인 검토 결과를 반환합니다.
작업은 순차적으로 실행되므로 씬 편집 순서가 유지됩니다. 차단된 작업에는 한 번의 수정 기회가 주어집니다. 두 번째 검토에서도 실패하면 워크플로가 중지됩니다. 작업 보드에는 진행 중인 할당, 시도 횟수 및 검토 결과가 표시됩니다.
외부 MCP 클라이언트 연결하기
내장 MCP 서버는 인증된 Streamable HTTP MCP를 사용하여 OpenCode 및 기타 호환 클라이언트를 지원합니다. 사이드바에서 OpenCode Portable을 실행할 수 있으며, OpenCode가 자체 프로바이더 로그인과 모델 선택을 관리합니다.
다른 MCP 클라이언트의 경우 프로젝트의 연결 가이드를 참고하고, 가이드에 설명된 인증된 로컬 엔드포인트를 사용하세요. 외부 클라이언트가 연결된 동안에는 Blender를 실행 상태로 유지하세요.
에셋 통합을 책임감 있게 사용하기
에셋 워크플로에는 Poly Haven, Sketchfab, Poly Pizza와의 통합이 포함됩니다. 필요한 경우 서비스 키를 구성하고, 검색하거나 가져오는 모든 에셋의 라이선스를 확인하세요.
유용한 워크플로는 어시스턴트에게 먼저 검색을 요청하고, 사용 가능한 옵션을 설명하게 한 다음, 선택한 에셋을 씬으로 가져오기 전에 승인을 요청하는 것입니다.
고급 사용 팁
- 편집 전에 검사하기: 복잡한 변경 작업을 실행하기 전에 씬 및 오브젝트 정보를 요청하세요.
- 큰 작업을 나누기: 여러 종속 작업이 포함된 경우 관리자, 작업자 및 검토자를 사용하세요.
- 뷰포트 피드백 요청하기: 중요한 변경 후 어시스턴트에게 뷰포트를 캡처하거나 표시하도록 요청하세요.
- 도구 사용이 가능한 모델 선택하기: 커스텀 모델과 호스팅 모델은 씬 작업을 위한 도구 호출을 지원해야 합니다.
- 필요할 때 이미지 인식 모델 사용하기: 이러한 모델은 뷰포트 스크린샷을 해석할 수 있습니다.
- 연결 분리하기: 자격 증명과 모델 선택을 체계적으로 관리하려면 저장된 작업용 연결과 개인 연결을 사용하세요.
- 승인 검토하기: 작업 승인, 취소 및 이름이 지정된 실행 취소 단계를 사용하여 씬 변경을 통제하세요.
- 에셋 라이선스 확인하기: 최종 프로젝트에 외부 에셋을 포함하기 전에 사용 권한을 확인하세요.
결론
mcp-for-blender-pro는 AI 채팅, Blender 씬 도구, 모델 연결, 시각적 피드백 및 MCP 자동화를 하나의 워크플로로 통합합니다. Blender 4.2 이상에 확장 기능을 설치하고, 지원되는 프로바이더 또는 로컬 Ollama 모델을 구성한 다음, 오브젝트 생성, 머티리얼, 에셋 및 내보내기 작업으로 넘어가기 전에 검사 프롬프트부터 시작하세요. 보다 복잡한 제작 작업에는 Studio 작업 보드와 에이전트 역할을 사용하여 순차적인 작업과 검토를 체계적으로 관리하세요.
설정에 대한 자세한 내용은 프로젝트의 빠른 시작 가이드와 GitHub 저장소를 참고하세요.