Blender MCP란
MCP(Model Context Protocol)는 에이전트에게 다른 프로그램을 조작하는 도구를 줘요. 두 Blender MCP 프로젝트는 모두 같은 두 부분으로 되어 있어요. Blender 안에서 작은 서버를 돌리는 애드온과, 에이전트가 시작해서 도구 호출을 TCP 소켓 위의 JSON으로 애드온에 전달하는 MCP 서버예요.
대부분 사람들이 말하는 건 mcp-for-blender예요. README는 서드파티 연동이며 Blender가 만든 것이 아니라는 고지로 시작해요. 라이선스는 MIT이고, 2026년 11월 21일 기준 GitHub 스타는 35,153개예요. PyPI 패키지 이름은 blender-mcp에서 mcp-for-blender로 바뀌었어요(11월 18일 버전 2.3.1). uvx blender-mcp로도 여전히 서버가 시작되니, 예전 설정도 그대로 동작해요.
Blender Lab의 blender_mcp가 공식 서버예요. readme는 일부러 작게 만든 가벼운 서버라고 소개하고, 목표는 Blender의 Python API를 자연어로 다루는 인터페이스, 문서에 대한 더 나은 접근, 복잡한 씬 탐색이라고 해요. Claude의 커넥터 디렉터리에도 Blender Lab이 만든 Blender로, Anthropic 검증 표시와 함께 올라와 있어요.
mcp-for-blender와 Blender Lab의 blender_mcp 비교
2026년 11월 21일 기준 GitHub와 projects.blender.org 저장소의 수치예요.
| mcp-for-blender (커뮤니티) | blender_mcp (Blender Lab) | |
|---|---|---|
| 만든 곳 | Siddharth Ahuja. Blender Foundation과 무관 | Blender Lab (Blender 프로젝트의 일부) |
| 라이선스 | MIT | GPL-3.0 |
| Blender 버전 | 3.0 이상 | 5.1 이상 |
| 스타 | GitHub 35,153개 | projects.blender.org 39개 |
| 도구 | 아홉 개. execute_blender_code, look(뷰포트와 카메라 시점), get_scene_info, 에셋 검색과 가져오기(Poly Haven, Sketchfab, Poly Pizza), generate_3d(Tripo, Hunyuan3D, Hyper3D Rodin, Meshy) 포함 | execute_blender_code, execute_blender_code_for_cli(백그라운드 Blender), blend 파일과 오브젝트 요약, get_python_api_docs, 스크린샷. Python API와 매뉴얼 발췌를 함께 제공 |
| 설치 | 한 줄 설치 스크립트 또는 uvx mcp-for-blender. Claude Code, Codex, Cursor 등의 설정을 내장 | 저장소를 git clone해서 uv로 실행하고, Blender에 애드온 추가 |
| 잘 맞는 용도 | 씬 구성과 꾸미기, 에셋 가져오기, 모델 생성 | 파일 점검과 Blender API 질문 (최신 Blender 기준) |
빠른 설치: 모든 에이전트를 한 번에
mcp-for-blender README가 권하는 방법은 명령 한 줄이에요. 필요하면 uv를 설치하고, 컴퓨터에 있는 MCP 클라이언트(Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity)를 찾아서, 설정할 것을 고르게 한 다음, Blender 애드온을 설치하고 켜요. 각 설정에는 blender 항목만 추가하고, 바꾼 파일마다 .bak을 남겨요. 끝나면 에이전트를 완전히 종료했다가 다시 여세요.
아래 명령은 README에서 그대로 가져온 것이고, 직접 실행해 보지는 않았어요. 스크립트를 셸에 파이프로 넘기면 내 권한으로 실행돼요. 단계를 하나씩 보고 싶다면 다음 두 섹션의 수동 설치를 쓰세요.
- macOS / Linux:
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh - Windows (PowerShell):
irm https://www.mcp-for-blender.com/install.ps1 | iex - uv가 이미 설치되어 있다면:
uvx mcp-for-blender setup - Blender 3.0 이상, Python 3.10 이상, uv가 필요해요.
Claude Code에 Blender MCP 설치하기
mcp-for-blender의 수동 설치예요. 명령은 프로젝트 README와 Claude Code MCP 문서에서 가져온 것이고, 직접 실행해 보지는 않았어요.
uv 설치
uv는 서버를 시작하는
uvx명령을 제공해요. README는pip install uv를 쓰지 말라고 경고해요. 공식 설치 스크립트를 쓰세요.# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -e서버 등록
현재 프로젝트용으로 서버를 저장해요. 어디서든 쓰려면
--scope user를 붙이세요. 이런 옵션은 서버 명령과 구분하는--앞에 두는데, Claude Code 문서가 쓰는 형태예요. 세션 안에서는/mcp로 같은 상태를 볼 수 있어요.# README의 명령 claude mcp add blender uvx mcp-for-blender # 확인: 서버가 connected로 보여야 해요 claude mcp list claude mcp get blender선택: 텔레메트리 끄기
README에 따르면 서버 환경에
DISABLE_TELEMETRY=true를 설정하면 텔레메트리가 완전히 꺼져요. Claude Code의claude mcp add는 환경 변수를--env로 받아요. 정확한 형태는 Claude Code MCP 문서를 보세요.Blender 애드온 설치하고 켜기
그다음 Blender에서 Edit → Preferences → Add-ons를 열고 "Interface: MCP for Blender"를 켜세요. 3D 뷰포트에서 N 키를 눌러 MCP for Blender 탭을 여세요. 서버는 Blender와 함께 시작되고, 실행 중이 아니면 Start MCP Server를 클릭하세요.
# 애드온을 Blender의 애드온 폴더에 blender_mcp.py로 복사해요 (.bak도 남겨요) uvx mcp-for-blender install-addon # 찾은 애드온 폴더를 나열해요 uvx mcp-for-blender addon-paths
Codex에 Blender MCP 설치하기
Codex CLI, 데스크톱 앱, IDE 확장은 ~/.codex/config.toml을 함께 쓰니, 한 번 설정하면 셋 다 적용돼요. 명령은 README와 OpenAI의 Codex MCP 문서에서 가져온 것이고, 직접 실행해 보지는 않았어요. uv와 Blender 애드온은 Claude Code 단계처럼 설치하세요.
CLI로 서버 추가
Codex는 다음에 시작할 때 도구를 보여 줘요. Codex 터미널 UI에서
/mcp를 입력하면 활성 서버가 나열돼요. 데스크톱 앱에서는 같은 일을 Settings → MCP servers → Add server에서 하고, 이름은blender, STDIO, 명령은uvx mcp-for-blender예요.# README의 명령 codex mcp add blender -- uvx mcp-for-blender # 확인: blender가 enabled로 보여야 해요 codex mcp list또는 config.toml 편집
[mcp_servers.blender]테이블은 README에서 가져왔어요.env줄은 Codex 문서를 따랐는데, 문서는 테이블 키로env,startup_timeout_sec(기본 10),tool_timeout_sec(기본 60)을 들어요. Blender의 긴 작업이 타임아웃되면tool_timeout_sec를 올리세요.# 또는 ~/.codex/config.toml에 직접 작성 (Codex CLI, 데스크톱 앱, IDE 확장이 함께 씀) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]선택: Codex 플러그인
README가 Codex에 권하는 방법이에요. 채팅 안에 실시간 Blender 뷰포트, 에셋 썸네일 선택기, 씬 오브젝트 @멘션이 나와요. 아직 Codex 플러그인 디렉터리에는 없어서, 저장소에서 추가해요.
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # 그다음 Codex를 재시작하고 플러그인 디렉터리에서 "MCP for Blender"를 설치하세요
대신 Blender Lab의 공식 서버 설치하기
Blender Lab의 설치 wiki는 Blender 5.1 이상에 그 애드온을 설치하고, 서버를 홈 폴더에 clone한 다음, MCP 클라이언트가 uv로 그곳을 가리키게 하라고 해요. 아래는 wiki의 clone 명령과 설정을 기록한 것이고, 직접 실행해 보지는 않았어요. Claude를 쓴다면 이 서버는 Claude의 커넥터 디렉터리에도 올라와 있고, 애드온이 필요하다고 적혀 있어요.
git clone https://projects.blender.org/lab/blender_mcp.git을 실행한 다음 {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}를 설정하세요.
두 프로젝트를 같은 blender 이름으로 등록하지 마세요. mcp-for-blender README도 서버 인스턴스는 한 번에 하나만 실행하라고 해요. 예를 들어 Cursor나 Claude Desktop 중 한 곳에서만 쓰고, 둘 다에서는 쓰지 마세요.
예시: 에이전트가 로우폴리 소품을 만들고 GLB로 내보내기
Blender를 열고 애드온이 실행 중이면, 에이전트는 execute_blender_code로 모델링하고 look으로 결과를 확인해요. 이 예시는 문서를 바탕으로 썼고 처음부터 끝까지 실행해 보지는 않았으니, 결과는 다를 수 있어요. GLB를 glTF-Transform으로 압축하고 three.js에서 불러오는 방법은 vibegamer.io의 Blender MCP 가이드를 보세요.
.blend 파일 저장
에이전트는 열려 있는 파일을 직접 편집해요. README의 경고는
execute_blender_code를 쓰기 전에 항상 작업을 저장하라는 거예요.에이전트에게 프롬프트 주기
크기, 삼각형 예산, 내보낼 경로를 알려 주세요. Blender의 glTF 내보내기가 Principled BSDF 노드에서 기본 색상을 읽기 때문에, 단색 기본 색상은 깔끔하게 내보내져요. README는 복잡한 작업은 더 작은 단계로 나눠야 할 수 있다고도 해요.
Blender MCP 도구를 사용해 주세요. 브라우저 게임용 로우폴리 나무 상자를 만들어 주세요. - 1 m 정육면체, 지면(z = 0) 위에 놓고 원점은 바닥 중심. - 모따기한 판자와 모서리 보강재, 삼각형 800개 미만. - Principled BSDF 기본 색상만 사용(나무, 어두운 금속), 이미지 텍스처 없음. - 모디파이어를 적용하고, 전부 "Crate"라는 이름의 오브젝트 하나로 합치기. - look 도구로 여러 각도에서 확인하고 떠 있는 부분이 있으면 고치기. - "Crate"만 선택해서 GLB로 ./public/models/crate.glb에 내보내기. 실행하기 전에 매번 스크립트를 보여 주세요.실행 전에 내보내기 스크립트 읽기
내보내기는 보통 Blender
export_sceneAPI의 매개변수를 쓰는 아래 같은 호출로 끝나요. GLB는 메시, 머티리얼, 텍스처를 파일 하나에 담아요. 경로가 프로젝트 안인지 확인하세요.import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # 메시, 머티리얼, 이미지를 바이너리 파일 하나로 use_selection=True, # 선택한 "Crate"만 export_apply=True, # 내보낼 때 모디파이어 적용 export_yup=True, # +Y가 위 )
Blender MCP는 안전한가요? 잠가 둘 것들
에이전트에게 Blender 안의 Python 셸을 주는 것과 같다고 생각하세요. 아래 내용은 mcp-for-blender README에 나와 있어요.
- 임의의 Python:
execute_blender_code는 에이전트가 쓴 어떤 Python이든 실행해요. README는 이를 잠재적으로 위험하다고 하며, 항상 먼저 작업을 저장하라고 해요. 승인하기 전에 스크립트를 읽으세요. - 세이프 모드:
BLENDER_MCP_SAFE_MODE=1을 설정하면 실행 전에 스크립트를 검증해요. 파일 직접 읽기·쓰기, 다른 프로그램 실행, 네트워크 접근, 지속되는 코드는 막아요. 모델링, 머티리얼, 렌더링, 저장, 가져오기/내보내기는 계속 돼요. - 소켓 인증 없음: 애드온의 서버(기본 포트 9876)에는 인증도 암호화도 없어서, 그 포트에 닿을 수 있는 사람은 누구나 Blender에서 Python을 실행할 수 있어요. 신뢰할 수 있는 네트워크가 아니라면
BLENDER_HOST를localhost로 두세요. - 텔레메트리: 기본으로 익명 설치 ID, 세션 ID, 도구 이름, 성공 여부, 소요 시간, 버전, OS, 타임스탬프를 보내요. 프롬프트, 생성된 코드, 스크린샷, 씬 데이터는 옵트인한 경우에만 전송되고, 옵트인한 데이터는 AI 모델 학습에 쓰일 수 있어요. 완전히 끄려면
DISABLE_TELEMETRY=true를 설정하세요. - 서드파티 키: 3D 생성과 일부 에셋 소스는 환경 변수로 넘기는 API 키(예:
BLENDERMCP_MESHY_API_KEY)를 써요. Poly Pizza 모델은 약 69%가 CC-BY라서, CC0로 필터링하지 않는 한 출처 표기가 필요해요.
Blender MCP일까, Blender 스킬일까
MCP 서버는 에이전트에게 실행 중인 Blender와의 실시간 연결을 줘요. 스킬은 워크플로를 위한 글로 된 지침과 스크립트를 줘요. 예를 들면 EL4CTEO/blender-skills(Claude Code, Codex 등에서 쓸 수 있는 Blender 5.2 LTS 이상용 워크플로 스킬 28개)가 있어요. 둘은 함께 쓰면 잘 맞아요. 스킬은 게임에 쓸 에셋을 어떻게 만들지 알려 주고, MCP 서버는 그걸 열려 있는 씬에서 하게 해 줘요.
Blender와 게임 제작용 스킬, MCP 서버는 게임 개발 스킬에 모아 두었고, vibegamer.io는 게임 개발 에이전트 스킬에서 비교해요.
Crewmark: 코더와 같은 보드에 있는 3D 아티스트
Blender MCP는 한 번에 세션 하나를 중심으로 만들어졌어요. 내가 프롬프트를 주면 에이전트가 모델링하고, 내가 리뷰하죠. 다른 에이전트들이 게임 코드를 짜는 동안 며칠에 걸쳐 계속 에셋을 만드는 에이전트가 필요하다면, Crewmark도 하나의 선택지예요.
Crewmark에서 에이전트는 AI 직원이에요. 직무를 가지고 내 컴퓨터에서 도는 장기 실행 세션이죠. Claude Code와 Codex 직원은 네이티브로 돌아가고, OpenCode, DeepSeek Harness, Gemini 같은 다른 에이전트는 ACP(acpx)로 연결해요. 작업은 공유 이슈 보드를 따라 움직여요. 사람과 직원이 이슈를 배정하고, 댓글을 달고, 서로 @멘션하고, 상태를 바꿔요. 코딩 직원이 Blender 직원에게 새 소품을 부탁하는 방식도 이슈에서 @멘션하는 거예요. 직원은 일정에 따라(하트비트) 그리고 멘션될 때마다 깨어나서, 사람이 전달하지 않아도 작업이 시작돼요.
Blender MCP를 대체하지는 않아요. 서버를 설치한 직원은 여전히 그걸 써요. 그 주변에 직무, 보드, 깨우기를 더해 줄 뿐이에요.
FAQ
Blender MCP는 무료인가요?
네. mcp-for-blender는 MIT 라이선스의 오픈 소스이고, 사이트에 따르면 3D 생성을 뺀 모든 기능을 무료 요금제에서 쓸 수 있어요. 3D 생성은 Premium 요금제(월 $10부터)나 직접 가진 제공업체 API 키가 필요해요. Blender Lab의 서버는 GPL-3.0으로 무료예요.
Blender MCP는 안전한가요?
에이전트가 쓴 어떤 Python이든 Blender 안에서 실행하고, 소켓 서버에는 인증이 없어요. 먼저 작업을 저장하고, 승인하기 전에 스크립트를 읽고, localhost로 두고, BLENDER_MCP_SAFE_MODE=1을 설정해서 파일 접근, 다른 프로그램, 네트워크 접근을 막으세요. 사용 텔레메트리는 DISABLE_TELEMETRY=true로 끌 수 있어요.
공식 Blender MCP 서버가 있나요?
네. Blender Lab이 projects.blender.org에 blender_mcp를 공개했어요(GPL-3.0, Blender 5.1 이상). Claude의 커넥터 디렉터리에도 Blender Lab이 만든 것으로 올라와 있어요. 인기 있는 mcp-for-blender는 Blender Foundation과 무관한 서드파티 프로젝트예요.
Claude Code에 Blender MCP를 어떻게 추가하나요?
uv를 설치하고, claude mcp add blender uvx mcp-for-blender를 실행하고, claude mcp list로 확인한 다음, uvx mcp-for-blender install-addon으로 Blender 애드온을 설치하고 켜세요. 또는 README의 한 줄 설치 스크립트를 실행하면 Claude Code 설정까지 해 줘요.
Codex에 Blender MCP를 어떻게 추가하나요?
codex mcp add blender -- uvx mcp-for-blender를 실행하거나, ~/.codex/config.toml에 command = "uvx"와 args = ["mcp-for-blender"]가 있는 [mcp_servers.blender] 테이블을 추가하세요. CLI, 데스크톱 앱, IDE 확장이 이 파일을 함께 써요. README에는 채팅 안에 실시간 뷰포트를 보여 주는 Codex 플러그인도 있어요.
Blender MCP와 Blender 스킬 중 뭘 써야 하나요?
에이전트가 실행 중인 Blender 씬에서 직접 작업해야 하면 MCP를, 검증된 워크플로를 따르게 하고 싶으면 스킬을 쓰세요. 많은 구성이 둘 다 써요. 스킬이 워크플로를 설명하고, MCP 서버가 그걸 실행해요.
2026년 11월 21일에 mcp-for-blender README, Blender Lab의 blender_mcp 저장소와 wiki, Claude Code와 Codex MCP 문서, Blender의 glTF 내보내기 문서와 대조해 명령과 기능을 확인했습니다. 설치 명령은 직접 실행해 보지 않았습니다.