macOS에서 Blender와 코딩 에이전트 연결하기
Blender와 코딩 에이전트를 연결하면 3D 작업을 코드로 생성하고 반복할 수 있다. 에이전트가 화면을 대신 조작하는 방식이 아니라, Blender의 Python API를 통해 장면과 오브젝트를 직접 제어하는 것이 핵심이다.
자동화의 기반: Blender Python API
Blender는 무료 오픈소스 3D 제작 도구이며 공식 Python API를 제공한다. 주요 모듈은 다음과 같다.1
bpy.context: 현재 작업 상태와 컨텍스트bpy.data: 장면, 오브젝트, 재질 등의 데이터bpy.ops: 모델링, 변환, 렌더링 등의 연산자
코딩 에이전트는 이 API를 이용해 오브젝트 생성, 재질 변경, 카메라 배치 같은 작업을 스크립트로 실행할 수 있다. 결과를 수정해야 할 때도 프롬프트나 코드를 바꿔 다시 실행하면 되므로, 동일한 작업을 재현하고 반복하기 쉽다.
완성된 장면은 편집 가능한 .blend 파일로 저장할 수 있다. 애니메이션은 이미지 시퀀스로 렌더링한 뒤 ffmpeg로 결합해 동영상으로 만들 수 있다. 공식 API 문서는 ZIP 형식의 HTML 파일로 내려받을 수 있어 오프라인 참고 자료로도 활용할 수 있다.1
macOS에서 MCP 연결 구성하기
blender-mcp는 Blender 내부에 소켓 서버를 만드는 애드온과 MCP를 구현하는 Python 서버로 구성된다. 이를 통해 코딩 에이전트가 Blender의 기능을 호출할 수 있다.2
최소 요구 사항은 Blender 3.0 이상, Python 3.10 이상, uv 패키지 관리자다. macOS에서는 다음 순서로 설정한다.2
uv를 설치한다.brew install uvChatGPT Codex에 MCP 서버를 등록한다.
codex mcp add blender -- uvx blender-mcpBlender 애드온을 설치한다.
uvx blender-mcp install-addonBlender 환경설정에서
Interface: MCP for Blender를 활성화한다.3D 뷰포트의 N 패널에서
MCP for Blender탭을 열고Start MCP Server를 누른다.
실제 사례에서는 macOS의 /Applications/Blender와 ChatGPT Codex를 함께 사용했으며, 예시 이미지는 Blender의 Python API로 생성됐다.
ChatGPT Codex가 uvx를 찾지 못한다면 다음 명령으로 설치 경로를 확인한 뒤 전체 경로를 등록해야 한다.
which uvxmacOS의 GUI 앱은 터미널과 동일한 PATH를 사용하지 않을 수 있으므로, 연결이 실패하면 서버 설정과 실행 경로부터 점검하는 것이 좋다.
안전하게 반복하는 작업 방식
이 구성은 Blender 안에서 Python 코드를 실행할 수 있으므로 편의성보다 실행 범위를 먼저 확인해야 한다. 중요한 파일과 분리된 프로젝트에서 시험하고, 필요하다면 BLENDER_MCP_SAFE_MODE=1을 설정해 파일 접근이나 외부 프로그램 실행 같은 위험 동작을 제한하는 편이 안전하다.2
처음부터 복잡한 장면을 만들기보다 다음과 같이 짧은 반복 단위로 작업하는 것이 효과적이다.
작은 장면이나 오브젝트를 생성한다.
.blend파일로 저장해 편집 가능성을 확인한다.카메라, 조명, 재질을 단계별로 수정한다.
테스트 이미지를 렌더링한다.
명령과 스크립트를 조정해 다시 실행한다.
이 접근의 가치는 한 번의 프롬프트로 완성품을 얻는 데 있지 않다. 작업 과정을 코드로 남기고, 결과를 검토하면서 안정적으로 재현하는 데 있다.
요약: Blender와 코딩 에이전트를 결합하면 3D 장면을 코드로 생성하고 반복 수정하며, 편집 가능한 파일과 렌더링 결과를 만들 수 있다. macOS에서는 MCP 설정, uvx 실행 경로, Python 코드의 권한과 안전 범위를 함께 점검해야 안정적으로 활용할 수 있다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.