보통 "Blender MCP"라고 하면 Siddharth Ahuja가 만든 오픈소스 프로젝트 MCP for Blender를 가리킵니다. 실행 중인 Blender를 AI 에이전트가 직접 조작할 수 있게 해 줍니다. 2026년 11월까지는 blender-mcp라는 이름이었고, 대부분의 튜토리얼은 아직 그 이름을 씁니다. 연결하면 Claude Code, Codex, Cursor, Claude Desktop이 채팅 프롬프트만으로 오브젝트를 만들고 고치고, 머티리얼을 적용하고, 뷰포트를 보고, 파일을 내보낼 수 있습니다.
이 글은 이것이 무엇인지, Claude Code와 Codex에 어떻게 설치하는지, 그리고 전체 예제를 다룹니다. 예제에서는 에이전트가 Blender에서 로우폴리 게임 소품을 만들어 GLB로 내보내고, glTF-Transform으로 파일을 압축한 뒤, three.js가 브라우저 게임에서 불러옵니다. 모든 명령어는 2026년 11월 21일에 프로젝트 README와 공식 문서로 확인했습니다. 설치와 예제는 직접 실행하지 않았으므로, 아래에 적은 결과는 문서상 그렇게 되어야 한다는 내용으로 읽어 주세요.
Blender MCP란
MCP(Model Context Protocol)는 AI 에이전트에 다른 프로그램을 조작하는 도구를 주는 표준 방식입니다. MCP for Blender는 두 부분으로 되어 있습니다.
- Blender 애드온: Blender 안에서 소켓 서버(기본 포트 9876)를 열고, 받은 명령을 실행합니다.
- MCP 서버(Python 패키지
mcp-for-blender): 에이전트가 백그라운드로 실행하며, 에이전트의 도구 호출을 애드온에 전달합니다.
에이전트는 주로 Blender Python을 작성해 열려 있는 Blender 파일에서 실행하는 방식으로 일합니다. README에는 도구가 아홉 개 나옵니다. 가장 자주 보게 될 것은 execute_blender_code(Blender에서 Python 실행), look(뷰포트, 카메라, 여러 각도 화면을 찍어 에이전트가 결과를 직접 확인), get_scene_info(씬 요약), search_assets / import_asset(Poly Haven, Sketchfab, Poly Pizza에서 모델, 텍스처, HDRI 가져오기)입니다. Meshy, Tripo, Hunyuan3D, Hyper3D Rodin으로 모델을 만드는 generate_3d도 있습니다.
Blender가 만든 것이 아닙니다. README는 "This is a third-party integration and not made by Blender"로 시작하고, GitHub 설명에도 "Not affiliated with the official Blender Foundation."이라고 적혀 있습니다. 라이선스는 MIT이고, 2026년 11월 21일 기준 GitHub 스타는 35,153개였습니다.
그래도 Blender에는 자체 MCP 서버가 있습니다. Blender 프로젝트의 일부인 Blender Lab이 projects.blender.org/lab/blender_mcp에 더 작은 서버를 공개했고, 문서는 blender.org/lab/mcp-server에 있습니다. readme는 이를 "deliberately small"(의도적으로 작게 만들었다)이라고 설명합니다. Blender의 Python API 문서, 씬과 파일 요약, 스크린샷, 코드 실행에 집중합니다. Blender 5.1 이상이 필요하고, GPL-3.0이며, 2026년 9월에 나온 v1.0.3이 최신이었습니다. Claude 커넥터 디렉터리에도 Blender Lab이 만든 "Blender"로 올라 있습니다. 이 서버는 Blender MCP 대안에서 다룹니다.
필요한 것
- MCP for Blender용 Blender 3.0 이상(애드온이 최소 버전을 3.0으로 선언합니다).
- Python 3.10 이상과 uv. uv는
uvx로 서버를 실행하는 도구이며, 아래 한 줄 설치 스크립트가 uv도 설치합니다. - MCP를 지원하는 에이전트: README에 따르면 Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf, Antigravity.
- 게임 부분에는 Node.js(glTF-Transform용)와 three.js 프로젝트가 필요합니다.
빠른 설치(모든 클라이언트 한 번에)
README가 권하는 방법은 명령 하나입니다. uv를 설치하고, 컴퓨터에 있는 에이전트를 찾고, 설정할 에이전트를 고르게 한 다음, Blender 애드온을 설치하고 켭니다. 각 설정 파일에는 blender 항목만 추가하며, 바꾸는 파일마다 .bak 백업을 남깁니다.
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
인터넷의 스크립트를 셸로 바로 넘기면 내 사용자 권한으로 실행됩니다. 그게 싫다면 같은 일을 한 단계씩 하는 아래 수동 방법을 쓰세요. 어느 쪽이든 끝나면 에이전트를 완전히 종료했다가 다시 여세요.
Claude Code에 Blender MCP 설치
- uv를 설치합니다. README에는 macOS는
brew install uv, Linux는curl -LsSf https://astral.sh/uv/install.sh | sh, Windows는winget install --id=astral-sh.uv -e가 나옵니다.pip install uv는uvx명령이 만들어지지 않을 수 있으니 쓰지 말라고 경고합니다. - 서버를 Claude Code에 등록합니다. README의 명령입니다.
claude mcp add blender uvx mcp-for-blender
- 확인합니다. Claude Code MCP 문서에는
claude mcp list("✔ Connected" 같은 상태가 표시됨)와claude mcp get blender가 나오고, 세션 안의/mcp패널에서도 같은 내용을 볼 수 있습니다.
claude mcp add는 기본적으로 서버를 현재 프로젝트에만 저장합니다. 모든 프로젝트에서 쓰려면 --scope user를 붙이세요. 문서의 일반 형식은 서버 명령을 -- 뒤에 둡니다: claude mcp add [options] <name> -- <command> [args...]. --scope나 --env 같은 옵션을 붙일 때는 --가 필요합니다.
프로젝트의 익명 사용 텔레메트리를 끄려면 README대로 서버에 환경 변수 DISABLE_TELEMETRY=true를 설정합니다. Claude Code에서는 -- 앞에 --env로 넘깁니다.
Codex에 Blender MCP 설치
Codex CLI, Codex 데스크톱 앱, IDE 확장은 설정 파일 ~/.codex/config.toml 하나를 공유하므로 한 번 설정하면 셋 모두에 적용됩니다.
일반 MCP 서버. README의 명령입니다.
codex mcp add blender -- uvx mcp-for-blender
~/.codex/config.toml에 직접 추가해도 됩니다.
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
codex mcp list를 실행해 blender가 enabled로 나오는지 확인하세요. 도구는 다음에 Codex를 시작할 때 나타나고, Codex 터미널 UI의 /mcp에서 활성 서버를 볼 수 있습니다. OpenAI의 Codex MCP 문서에는 환경 변수용 env 테이블, startup_timeout_sec(기본값 10), tool_timeout_sec(기본값 60)도 나옵니다. 데스크톱 앱에서는 Settings → MCP servers → Add server로 가서 이름을 blender로 하고 STDIO를 고른 뒤 uvx mcp-for-blender를 입력합니다.
Codex 플러그인. README가 Codex에 권하는 방법입니다. 채팅 안에 실시간 Blender 뷰포트, Poly Haven, Sketchfab, Poly Pizza용 썸네일 선택기, 씬 오브젝트용 @ 멘션이 추가됩니다. 아직 Codex 플러그인 디렉터리에는 없어서 저장소에서 추가합니다.
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex
그다음 Codex를 재시작하고, 플러그인 디렉터리에서 MCP for Blender를 설치한 뒤 Codex에 사용하라고 말하세요.
Cursor와 기타 클라이언트
Cursor에서는 Settings → MCP를 열어 글로벌 서버를 추가하거나, 프로젝트에 .cursor/mcp.json을 만들어 다음을 넣습니다.
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"mcp-for-blender"
]
}
}
}
Windows에서 README는 "command": "cmd"와 "args": ["/c", "uvx", "mcp-for-blender"]를 씁니다. README에는 Cursor와 VS Code용 원클릭 설치 버튼, Claude Desktop, OpenCode, Antigravity용 설정 블록도 있습니다. 서버는 한 번에 하나만 실행하라고 합니다. 예를 들어 Cursor와 Claude Desktop 중 하나만 쓰고 둘 다 쓰지 마세요.
Blender 애드온 연결
빠른 설치 스크립트가 이 과정을 대신 해 줍니다. 수동으로 하려면:
uvx mcp-for-blender install-addon을 실행합니다. 애드온이blender_mcp.py라는 이름으로 Blender 애드온 폴더에 복사됩니다.- Blender에서 Edit → Preferences → Add-ons를 열고 Interface: MCP for Blender를 켭니다. 목록에 없으면 Blender를 재시작하거나, **Install…**을 눌러 복사된 파일을 고르세요. 저장소에서
addon.py를 받아 설치해도 됩니다. - 3D 뷰포트에서 N을 눌러 사이드바를 열고 MCP for Blender 탭을 찾습니다. 애드온은 Blender가 열릴 때 서버를 시작합니다. 실행 중이 아니면 Start MCP Server를 누르세요.
이 탭에서 Poly Haven, Poly Pizza(무료 API 키 필요), 3D 생성기 같은 선택 기능을 켭니다.
에이전트가 연결되지 않으면: 애드온이 실행 중인 Blender가 열려 있는지 확인하고, 터미널에서 uvx mcp-for-blender를 직접 실행하지 마세요(README의 문제 해결 표가 그렇게 안내합니다). Dock이나 시작 메뉴에서 실행한 앱은 uvx를 못 찾아 spawn uvx ENOENT로 실패할 수 있습니다. 이때는 which uvx(macOS/Linux) 또는 where uvx(Windows)로 나온 전체 경로를 명령으로 쓰세요. 그래도 안 되면 에이전트와 Blender를 모두 재시작하세요.
예제: 로우폴리 게임 소품, 프롬프트에서 three.js까지
목표는 브라우저 게임용 보물상자입니다. 빨리 불러올 수 있을 만큼 작고, three.js가 바로 읽는 형식이어야 합니다. 이 작업 흐름은 문서를 보고 썼으며 처음부터 끝까지 실행해 보지는 않았으므로, 파일 크기와 정확한 결과는 다를 수 있습니다.
1. 먼저 Blender 파일을 저장하세요
에이전트가 시작하기 전에 새 Blender 파일을 열고 저장하세요(예: chest.blend). 에이전트는 파일을 직접 바꾸고, README 자체도 항상 작업을 먼저 저장하라고 경고합니다.
2. 에이전트에 프롬프트 보내기
Blender가 열려 연결된 상태에서 Claude Code나 Codex에 보냅니다.
Use the Blender MCP tools. In the current scene, build a low-poly treasure chest
for a browser game:
- About 1 m wide, 0.6 m deep, 0.7 m tall, sitting on the ground at z = 0,
origin at the bottom centre.
- A box body and a curved lid made from a half-cylinder with 8 segments,
plus metal bands and a lock plate. Keep it under 1,500 triangles.
- Flat-shaded materials using Principled BSDF base colours only
(dark wood, brass), no image textures.
- Apply all modifiers and transforms, join everything into one object named "Chest".
- Check it with the look tool from several angles and fix anything that
overlaps or floats.
- Then select only "Chest" and export it as a GLB to ./public/models/chest.glb.
Show me each script before you run it.
이 프롬프트의 몇 가지 선택은 게임에서 중요합니다. Blender glTF 매뉴얼에 따르면 glTF 익스포터는 Principled BSDF 노드에서 베이스 컬러를 가져오므로, 단색 베이스 컬러는 깔끔하게 내보내집니다. 오브젝트를 하나로 합치면 three.js에서도 메시 하나가 됩니다. 원점을 바닥에 두면 위치를 y = 0으로 했을 때 상자가 바닥에 놓입니다. 삼각형 예산을 정해 두면 에이전트가 서브디비전을 추가하지 못합니다.
3. 내보내기 단계
Blender Python은 에이전트가 작성합니다. 내보내기는 보통 아래와 같은 호출로 끝나며, Blender의 export_scene API에 문서화된 매개변수를 씁니다.
import bpy
bpy.ops.export_scene.gltf(
filepath="/path/to/your-game/public/models/chest.glb",
export_format='GLB', # single binary file: mesh, materials and images packed together
use_selection=True, # only the selected "Chest" object
export_apply=True, # apply modifiers on export
export_yup=True, # glTF's +Y up convention, which three.js also uses
)
에이전트가 실행하는 모든 스크립트와 마찬가지로, 승인하기 전에 이 스크립트를 읽어 보세요. 경로가 프로젝트 안을 가리키는지, 소중한 파일을 지우거나 덮어쓰는 코드가 없는지 확인하세요.
4. glTF-Transform으로 GLB 압축
glTF-Transform은 glTF 파일을 최적화하는 명령줄 도구입니다. 설치하고 optimize를 실행합니다. 아래는 README의 명령입니다.
npm install --global @gltf-transform/cli
gltf-transform optimize input.glb output.glb --texture-compress webp
상자의 경우:
gltf-transform optimize public/models/chest.glb public/models/chest.opt.glb --texture-compress webp
optimize는 기본적으로 지오메트리를 meshopt(--compress meshopt)로 압축하고, 텍스처를 2048px로 제한하며, 씬 그래프를 평탄화합니다. 이 상자에는 이미지 텍스처가 없어서 --texture-compress webp가 할 일이 없지만, 텍스처가 있는 소품을 위해 남겨 두세요. 지오메트리만 압축하려면 glTF-Transform에 gltf-transform meshopt input.glb output.glb --level medium도 있습니다.
5. three.js에서 불러오기
meshopt로 압축한 파일에는 meshopt 디코더가 필요합니다. 없으면 GLTFLoader가 "setMeshoptDecoder must be called before loading compressed files"를 던집니다. 아래 import는 three.js 자체 예제에서 쓰는 것과 같습니다.
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
const loader = new GLTFLoader();
loader.setMeshoptDecoder(MeshoptDecoder);
const gltf = await loader.loadAsync('/models/chest.opt.glb');
const chest = gltf.scene;
chest.position.set(0, 0, -3); // origin is at the bottom, so y = 0 puts it on the floor
scene.add(chest);
Blender도 대부분의 three.js 씬도 미터 단위를 쓰므로 상자는 너비 약 1 m로 불러와져야 합니다. 옆으로 누운 채 들어온다면 내보낼 때 export_yup이 빠졌을 가능성이 큽니다. 새까맣게 보인다면 씬에 조명이 필요합니다. HemisphereLight나 환경 맵을 추가하세요.
6. 반복하기
Blender 파일을 열어 둔 채 "뚜껑이 40도 열리게, Lid라는 별도 오브젝트로 만들어 줘"나 "안에 금화 더미를 추가해 줘" 같은 수정을 요청하세요. 그런 다음 내보내기와 optimize 명령을 다시 실행합니다. 에이전트에게 내보내기 스크립트를 프로젝트에 보관하게 하면 매번 같은 설정을 쓸 수 있습니다.
한계와 안전
- Blender 안에서 어떤 Python이든 실행합니다. README의 경고는 이렇습니다: "The
execute_blender_codetool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous." Blender의 Python은 내 사용자 계정이 읽고 쓸 수 있는 모든 파일에 접근할 수 있습니다. 에이전트에게 스크립트를 실행 전에 보여 달라고 하고, 직접 읽어 보세요. - 세션 전에 파일을 저장하세요. 같은 경고가 이렇게 끝납니다: "ALWAYS save your work before using it." 작업하면서 버전을 저장하세요(File → Save Incremental).
- 파일이나 네트워크 접근이 필요 없으면 안전 모드를 켜세요. 서버에
BLENDER_MCP_SAFE_MODE=1을 설정합니다. 그러면 모든 스크립트가 실행 전에 검사되고, 파일을 직접 읽고 쓰는 코드, 다른 프로그램을 실행하는 코드, 네트워크를 쓰는 코드, 스크립트가 끝난 뒤에도 계속 도는 코드가 차단됩니다. 모델링, 머티리얼, 렌더링, 저장, 가져오기/내보내기는 그대로 됩니다. - localhost에만 두세요. 애드온의 소켓에는 인증도 암호화도 없습니다. 그 포트에 닿을 수 있는 사람은 누구나 내 Blender에서 Python을 실행할 수 있습니다. 믿을 수 없는 네트워크에 노출하지 마세요.
- 큰 작업은 단계로 나누세요. README는 복잡한 작업은 더 작은 단계가 필요할 수 있고, 타임아웃은 요청을 단순하게 해서 해결한다고 합니다. Poly Haven 다운로드는 Blender의 메인 스레드에서 실행되므로 끝날 때까지 Blender가 멈춥니다.
- 에셋 라이선스를 확인하세요. Poly Haven은 CC0입니다. Poly Pizza의 약 69%는 CC-BY로, 출처 표기가 필요합니다. 애드온은 가져온 오브젝트에 크레딧 문구를 적어 주고,
licence="CC0"로 검색할 수도 있습니다. - 텔레메트리. 기본적으로 서버는 익명 사용 기록(설치 ID, 세션 ID, 도구 이름, 성공 여부, 소요 시간, 버전, OS, 타임스탬프)을 보냅니다. 프롬프트, 코드, 스크린샷, 씬 데이터는 직접 동의해야만 수집됩니다.
DISABLE_TELEMETRY=true로 전부 끌 수 있습니다.
Blender MCP 대안
- Blender Lab의 Blender MCP: Blender의 자체 서버입니다. 더 작고, Python API 문서, 씬과 파일 요약, 스크린샷, 코드 실행을 중심으로 만들었으며
.blend파일용 백그라운드 모드도 있습니다. Blender 5.1 이상이 필요하고 GPL-3.0입니다. 위키의 설치 방법은 저장소를 클론해uv --directory .../blender_mcp/mcp run blender-mcp로 실행하는 것입니다. 공식 프로젝트를 원하고 에셋 검색이나 AI 모델 생성이 필요 없다면 이것을 고르세요. - Blender Agent Skills: Blender 5.2 LTS 이상용 스킬 28개(모델링, UV, 베이킹, 리깅, 애니메이션, 최적화, 내보내기). Claude Code, Codex, OpenCode, Gemini CLI, Copilot, Cursor에서 쓸 수 있습니다. MIT. 스킬은 에이전트에게 일하는 법을 가르치고, MCP 서버는 Blender 제어권을 줍니다. 둘을 함께 쓸 수 있습니다.
- blender-game-skills: 콘셉트 아트에서 리깅된 게임용 3D 에셋까지 만드는 Claude Code 스킬. MIT.
- 완성된 모델. 흔한 소품은 무료 모델이 직접 생성하는 것보다 빠른 경우가 많습니다. Polyfork의 로우폴리 GLB를 보세요.
게임 개발용 에이전트 스킬과 MCP 서버 목록에서 Godot, Unity, Unreal, three.js의 대응 도구를 볼 수 있습니다.
자주 묻는 질문
Blender MCP는 무료인가요?
네. MCP for Blender는 MIT 라이선스이고 애드온은 무료입니다. Premium 페이지에 따르면 모든 기능이 무료 플랜에서 작동하고 3D 생성만 유료입니다. Meshy, Tripo, Hunyuan3D, Hyper3D Rodin, World Labs를 내 API 키로 쓰거나, Premium(2026년 11월 21일 기준 월 $10부터)을 구독해 키 없이 쓸 수 있습니다. Blender Lab의 서버는 GPL-3.0으로 무료입니다. AI 에이전트의 구독료나 API 사용료는 따로 냅니다.
Blender MCP는 안전한가요?
실행을 허락한 코드만큼만 안전합니다. 에이전트가 Blender 안에서 Python을 실행하고, 그 Python은 내 사용자 권한으로 파일에 접근합니다. 작업을 저장하고, 스크립트는 승인 전에 읽고, 안전 모드(BLENDER_MCP_SAFE_MODE=1)를 쓰고, 애드온 포트는 localhost에만 두세요. 누가 다시 올린 사본이 아니라 공식 저장소나 프로젝트의 설치 스크립트로 설치하세요.
공식 Blender MCP 서버가 있나요?
네. Blender Lab이 projects.blender.org/lab/blender_mcp에 공개하고 있고, Claude 커넥터 디렉터리에는 Blender Lab이 만든 "Blender"로 올라 있습니다. 더 유명한 MCP for Blender(예전 이름 blender-mcp)는 Blender Foundation과 관련 없는 서드파티 프로젝트입니다.
Blender MCP는 Claude Code에서 되나요?
네. claude mcp add blender uvx mcp-for-blender를 실행하고, 애드온을 켠 채 Blender를 열고, claude mcp list로 확인하세요. Claude Desktop은 대신 claude_desktop_config.json에 JSON 블록으로 설정합니다.
Blender MCP는 Codex에서 되나요?
네. codex mcp add blender -- uvx mcp-for-blender를 실행하거나 ~/.codex/config.toml에 [mcp_servers.blender]를 추가하세요. README는 채팅 옆에 실시간 Blender 뷰포트를 보여 주는 Codex 플러그인도 제공합니다.
Blender MCP는 ChatGPT에서 되나요?
README에 나온 것은 데스크톱과 코딩 클라이언트(Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity)이고 ChatGPT 앱은 없습니다. 이 용도에는 OpenAI의 에이전트인 Codex가 있습니다. 서버는 내 컴퓨터에서 실행 중인 Blender와 통신하므로, 로컬 MCP 서버를 실행할 수 있는 클라이언트가 필요합니다.
Blender MCP 탭은 어디에 있나요?
Blender의 3D 뷰포트에서 N을 눌러 사이드바를 여세요. 탭 이름은 MCP for Blender입니다. 없다면 Edit → Preferences → Add-ons에서 Interface: MCP for Blender를 켜세요.
Blender MCP와 Blender 스킬 중 무엇을 쓸까요?
MCP 서버는 에이전트가 실행 중인 Blender에서 오브젝트를 만들고, 뷰포트를 보고, 내보내게 해 줍니다. 스킬은 에이전트에게 Blender 작업 방식과 관례를 가르치며, MCP로 작업하든 명령줄에서 Blender를 헤드리스로 돌리든 도움이 됩니다. 게임 에셋에는 둘을 함께 쓰는 것이 좋습니다. MCP 서버가 만들고, Blender Agent Skills 같은 스킬 팩이 UV, 최적화, 내보내기 설정을 맡습니다.
출처
2026년 11월 21일에 확인: mcp-for-blender README, MCP for Blender Premium, Blender Lab blender_mcp와 설치 위키, Claude Code MCP 문서, Codex MCP 문서, Blender export_scene API, Blender glTF 2.0 매뉴얼, glTF-Transform CLI, three.js GLTFLoader.


