掘金2026년 9월 16일 14:00중국어 → 한국어

자연어로 Blender 제어하는 오픈소스 Blender MCP

Blender MCP는 MCP 프로토콜로 Blender와 LLM을 연결해 자연어로 모델링, 재질, 장면과 코드 실행을 실시간 제어하는 오픈소스 프로젝트다.

중국어 원문을 AI로 번역했습니다. 고유명사와 수치는 원문 표기를 우선하며, 중요한 판단에는 아래 출처 원문을 함께 확인하세요.

3D 창작 분야에서 Blender는 줄곧 무료이면서 기능이 강력한 도구였다. 그러나 전통적인 사용 방식은 여전히 수작업과 Python 스크립트 작성에 크게 의존한다. 최근 들어 대규모 모델의 성능이 향상되고, Model Context Protocol(MCP)과 같은 표준화 프로토콜이 등장하면서 새로운 상호작용 방식이 나타나기 시작했다: 바로 자연어로 Blender를 직접 구동하는 것이다.

Blender MCP (GitHub 저장소: github.com/ahujasid/bl… )는 바로 이러한 방향의 대표적인 프로젝트다. 이는 MCP 프로토콜을 통해 Blender를 해당 프로토콜을 지원하는 각종 LLM 클라이언트(Claude Desktop, Cursor, VS Code, Codex 등)와 연결하여 실시간 양방향 장면 조작을 구현한다.

현재까지 이 저장소는 2.8만 개가 넘는 Star를 받았고, Fork 수 역시 2600개를 넘어 커뮤니티 활성도가 높으며, 여전히 지속적으로 업데이트되고 있다.

프로젝트 포지셔닝과 핵심 가치

Blender MCP의 목표는 명확하다: 사용자가 자연어를 통해 Prompt-assisted 방식의 3D 모델링, 장면 생성 및 조작을 완수하도록 하는 것이다.

이는 단순히 텍스트를 이미지로 변환한 뒤 가져오는 것이 아니라, 실제로 실행 중인 Blender 인스턴스 안에서 작업을 수행한다——오브젝트 생성, 재질 조정, 장면 상태 조회, 임의의 Python 코드 실행, 심지어 외부 에셋을 가져오거나 AI로 모델을 생성하는 것까지 말이다.

이러한 능력은 특히 다음 사람들에게 실질적인 의미가 있다:

- 아이디어를 빠르게 검증해야 하는 디자이너나 제품 관리자

- 대량의 스크립트 작성이 서투르거나 하고 싶지 않은 창작자

- AI 능력을 기존 Blender 워크플로에 융합하고 싶은 사람

- 3D를 배우는 초보자로서 대화 방식으로 진입 장벽을 낮추고 싶은 사람

프로젝트는 MIT 라이선스를 채택하며, 제3자 커뮤니티에서 개발한 것(Blender 공식 아님)으로, 이 점은 README에도 명확히 명시되어 있다.

기술 아키텍처 개요

전체 시스템은 두 개의 핵심 컴포넌트로 구성된다:

Blender 플러그인 ( addon.py )

Blender 내부에서 실행되며 socket 기반 서버를 생성한다. 이는 명령을 수신하고, 해당 작업을 실행하며, 결과를 반환하는 역할을 한다. 플러그인은 Blender의 3D 뷰 사이드바에 「MCP for Blender」 패널을 제공하여 서비스를 시작/중지하기 편리하게 한다.

MCP Server (Python 구현, src/blender_mcp 에 위치)

중간 계층으로서 각종 MCP 클라이언트와对接한다. 클라이언트는 표준 입출력을 통해 MCP Server와 통신하고, MCP Server는 다시 socket을 통해 Blender 플러그인과 상호작용한다.

이러한 설계는 몇 가지 이점을 가져온다:

- 클라이언트는 MCP를 지원하는 임의의 도구가 될 수 있으며, 특정 모델에 묶이지 않는다

- Blender 자체는 상대적으로 독립적으로 유지되며, 플러그인은 실행만 담당한다

- MCP Server를 Docker 방식으로 실행하는 것을 지원한다(Blender는 여전히 로컬에서 실행)

통신은 양방향이다: AI는 명령을 내릴 수 있을 뿐만 아니라 현재 장면 정보를 조회하고, 그 피드백에 따라 계속 작업할 수 있다. 이는 단방향 '결과 생성' 모드보다 실제 협업에 더 가깝다.

주요 기능 개요

프로젝트가 현재 지원하는 능력은 다음과 같은 몇 가지 범주로 정리할 수 있다:

기초 조작

- 3D 오브젝트 생성, 수정, 삭제

- 위치, 회전, 스케일 등의 변형 조정

- 재질 생성 및 색상/속성 수정

- 장면 정보 조회(오브젝트 목록, 위치, 속성 등)

고급 능력

- Blender에서 임의의 Python 코드를 직접 실행

- Poly Haven에서 에셋과 HDRI 가져오기

- Sketchfab, Poly Pizza에서 모델 가져오기

- Hyper3D Rodin, Hunyuan3D 등을 통해 AI 3D 모델 생성

- 장면 내보내기 관련 기능(최근 업데이트에서 지속적으로 개선 중)

기타 특징

- 안전 모드(Safe Mode) 지원, 일부 고위험 작업 제한

- host/port 설정 제공, 네트워크 환경 조정에 편리

- 노드 및 API introspection 등 더 심층적인 디버깅 능력 지원(최근 PR에서 확인 가능)

이러한 기능들은 단순 프로토타입부터 중간 정도의 복잡도를 지닌 장면까지의 흔한 요구를 포괄한다. 복잡한 애니메이션, 고급 리깅 또는 고강도 지오메트리 노드 워크플로는 현재로선 여전히 전통적인 방식이 더 적합하지만, 기초에서 중급 수준의 모델링과 장면 구축은 이미 자연어를 통해 상당 부분 완수할 수 있다.

설치와 설정 상세

환경 요구 사항

- Blender 3.0 이상 버전

- Python 3.10+

- uv 패키지 관리자(공식 설치 스크립트 사용을 강력히 권장하며, pip install uv 는 사용하지 말 것)

1. uv 설치

macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

설치 후 uvx 명령이 PATH에서 사용 가능한지 확인하라. 만약 클라이언트가 그래픽 인터페이스에서 시작된 경우(예: Claude Desktop, Cursor), 때때로 uvx 를 찾지 못할 수 있는데, 이때는 절대 경로를 사용하거나, Windows에서는 cmd /c uvx ... 방식으로 감싸야 한다.

2. MCP 클라이언트 설정

Claude Desktop을 예로 들면, 설정 파일에 다음을 추가한다:

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

Python 버전 충돌(특히 conda/pyenv 환경)을 피하기 위해 다음과 같이 명시적으로 지정할 수 있다:

{ "mcpServers" : { "blender" : { "command" : "uvx" , "args" : [ "--python" , "3.11" , "blender-mcp" ] , "env" : { "UV_PYTHON_PREFERENCE" : "only-managed" } } } }

기타 클라이언트(Cursor, VS Code, Claude Code, Codex 등)의 설정 방식은 프로젝트 README에 상세히 설명되어 있으며, 기본 패턴은 유사하다.

3. Blender 플러그인 설치

uvx blender-mcp install-addon

설치가 완료되면 Blender를 열고 → Edit → Preferences → Add-ons 로 가서 Interface: MCP for Blender 를 검색하여 활성화한다.

4. 서비스 시작

3D 뷰에서 N을 눌러 사이드바를 열고, MCP for Blender 탭으로 전환한 뒤, Start MCP Server 를 클릭한다. 상태가 실행 중으로 바뀌면 해당 MCP 클라이언트에서 대화를 시작할 수 있다.

주의 사항

- 동시에 하나의 MCP 클라이언트 인스턴스만 실행하는 것을 권장하며, 충돌을 피해야 한다.

- Docker로 MCP Server를 실행하는 경우, 컨테이너가 로컬 Blender에 접근할 수 있도록 네트워크를 올바르게 설정해야 한다(macOS/Windows는 host.docker.internal 사용 가능, Linux는 일반적으로 --network=host 필요).

사용 예시와 워크플로 제안

연결에 성공하면 자연어로 요구 사항을 직접 설명할 수 있다. 다음은 실제로 시도해 볼 수 있는 몇 가지 명령 방향이다:

기초 장면 구축

- “간단한 실내 장면을 만들어 줘: 바닥, 사방의 벽, 창문 하나, 그리고 테이블 하나와 의자 두 개를 놓아 줘”

- “테이블 위에 찻잔 하나와 책 한 권을 놓고, 합리적인 비율로 조정해 줘”

재질과 조명

- “테이블에는 나무 재질을 추가하고, 의자는 짙은 회색 직물로, 그리고 부드러운 상단 조명을 하나 추가해 줘”

- “창문 위치의 빛을 좀 더 밝게 조정해서 낮 효과를 시뮬레이션해 줘”

조회와 반복

- “먼저 현재 장면에 어떤 오브젝트들이 있는지, 그리고 그 위치를 알려 줘”

- “방금 정보를 바탕으로 의자를 오른쪽으로 0.5 단위 이동시키고, 15도 회전시켜 줘”

코드 실행

- “선택한 오브젝트에 Subdivision Surface 수정자를 추가하고, 레벨을 2로 설정해 줘”

- “Python으로 장면에서 카메라와 조명이 아닌 모든 오브젝트를 비워 줘”

에셋과 생성

- “Poly Haven에서 실내 HDRI를 다운로드해서 월드 환경에 적용해 줘”

- “AI로 로우 폴리 스타일의 SF 의자 모델을 생성해 봐 줘”

실제 사용에서 비교적 효율적인 워크플로는 보통 다음과 같다:

- 먼저 AI에게 현재 장면 상태를 조회하게 한다

- 피드백에 기반해 정확한 명령을 내린다

- 매우 복잡한 장면을 한 번에 설명하기보다는 작은 단위로 반복한다

- 핵심 단계에는 수동으로 조정할 여지를 남겨 둔다

이러한 방식은 반복적인 시행착오 시간을 현저히 줄여 주며, 특히 프로토타입 검증 단계에 적합하다.

현재의 한계와 사용 시 유의점

어떤 도구든 경계가 있듯, Blender MCP도 예외가 아니다:

- 복잡한 리깅, 고급 애니메이션 커브, 고강도 지오메트리 노드 네트워크는 현재로선 여전히 수동 또는 스크립트 방식이 더 적합하다

- 임의의 Python 코드를 실행하는 능력은 매우 강력하지만, 그만큼 일정한 보안 의식이 필요하다(프로젝트는 Safe Mode를 제공)

- 네트워크 환경, 방화벽, 클라이언트 PATH 문제는 흔한 설치 걸림돌이다

- AI의 3D 공간 관계에 대한 이해는 여전히 편차가 발생할 수 있어, 결과를 사람이 확인해야 한다

프로젝트는 이러한 부분을 지속적으로 개선하고 있으며, 최근 업데이트에는 host/port 설정, 노드 introspect, 장면 내보내기 등의 기능이 포함되어 있어 개발이 여전히 활발히 추진되고 있음을 보여 준다.

커뮤니티와 향후 발전

저장소는 활발히 유지되고 있으며, 교류할 수 있는 Discord 커뮤니티도 있고 후원 채널도 있다. README에는 완전한 튜토리얼 영상 링크가 제공되어 있어, 설치나 사용 문제가 있으면 먼저 공식 문서와 커뮤니티 논의를 참고할 수 있다.

이미 Blender를 사용하고 있고 자연어 상호작용을 워크플로에 도입해 보고 싶다면, 이 프로젝트는 비교적 성숙한 진입점을 제공한다. 직접 설치해 체험하는 것이 단순히 소개만 보는 것보다 실제 차이를 더 잘 느낄 수 있다.