Blender MCP server

"Blender MCP"를 검색하면 이름이 바뀐 프로젝트의 설치 가이드, 모든 포크를 나열한 디렉터리 페이지가 나오고, Blender에 자체 서버가 생겼다는 사실에 대해서는 거의 아무 정보도 나오지 않습니다. 중요한 프로젝트는 두 개이고, 하는 일이 다르며, 둘 다 같은 포트를 기본값으로 사용하기 때문에 어느 쪽을 설치하는지 아는 것이 중요합니다.

2026년 11월 14일에 두 프로젝트의 소스와 문서를 읽었고, Blender 5.2.3이 설치된 Mac에서 MCP Inspector로 MCP for Blender 2.2.9를 실행했으며, 같은 날 GitHub, PyPI, projects.blender.org에서 수치를 확인했습니다.

두 서버

	MCP for Blender	Blender Lab MCP server
개발	ahujasid와 커뮤니티 기여자	Blender 프로젝트의 일부인 Blender Lab
저장소	ahujasid/mcp-for-blender (이전 이름 blender-mcp)	projects.blender.org/lab/blender_mcp
라이선스	MIT	GPL-3.0-or-later
스타	GitHub에서 34,351	projects.blender.org에서 37
최신 버전	PyPI 기준 2.2.9, 2026년 11월 13일	v1.0.3, 2026년 9월 11일
Blender	3.0 이상	5.1 이상
도구	10개	26개
강점	장면 구성: 코드 실행, 결과 확인, 에셋 가져오기, 모델 생성	장면 파악: 요약, 문서 검색, 스크린샷, 오브젝트로 이동
Claude에서	uvx를 통한 모든 클라이언트	Claude Desktop의 Blender 커넥터

두 서버는 내부적으로 같은 방식으로 동작합니다. Blender에는 네트워크 API가 없어서, 각 프로젝트는 두 부분을 함께 제공합니다. Blender 안에서 TCP 소켓을 여는 애드온과, 클라이언트가 실행하는 MCP server입니다. 클라이언트는 MCP로 서버와 통신하고, 서버는 소켓으로 명령을 보내며, 애드온은 Blender의 메인 스레드에서 명령을 실행합니다. 그래서 어떤 도구든 동작하려면 애드온이 먼저 활성화되어 실행 중이어야 합니다.

어느 쪽을 고를지는 모델에게 무엇을 시키고 싶은지에 달려 있습니다. 모델이 장면을 모델링하고 조명을 넣고 꾸미기를 원한다면 MCP for Blender가 그 반복 작업에 맞춰져 있습니다. Python을 작성하고, 뷰포트를 확인하고, 고치고, 다시 반복하는 흐름입니다. 누군가 보낸 파일을 이해하거나, 빠진 텍스처를 찾거나, "Python API에서 이건 어떻게 하나요"에 답하는 데 도움이 필요하다면 Blender Lab의 서버가 의도적으로 더 좁은 범위를 다루며 Blender 자체 매뉴얼과 API 문서를 함께 갖추고 있습니다.

커뮤니티 서버, MCP for Blender

대부분의 튜토리얼이 "Blender MCP"라고 부르는 것이 바로 이것입니다. 2025년 3월에 처음 공개되어 34,000개 이상의 스타를 받았고, 2026년 9월에 blender-mcp에서 MCP for Blender로 이름이 바뀌었습니다. 이름 변경에 대한 메인테이너의 설명에 따르면 깨지는 것은 없습니다. uvx blender-mcp는 호환 패키지를 통해 여전히 동작하고, import 경로는 그대로이며, 애드온도 같은 파일입니다. 변경 이유 중 하나는 공식 Blender Lab 프로젝트와의 혼동을 피하기 위해서였습니다. README에도 Blender Foundation과 무관하다는 점이 분명히 적혀 있습니다.

열 개의 도구가 하는 일

MCP Inspector의 CLI로 버전 2.2.9를 대상으로 도구를 나열해 보니 열 개가 나왔습니다. README의 "nine tools" 문구보다 하나 많습니다:

도구	하는 일
execute_blender_code	실행 중인 Blender 세션에서 Python을 실행합니다
look	뷰포트, 카메라, 다각도 시트 또는 애니메이션 프레임을 solid, material, rendered, wireframe, x-ray로 보여줍니다
get_scene_info	오브젝트, 크기, 머티리얼, 메시 상태를 텍스트로 요약합니다
search_assets	Poly Haven, Sketchfab, Poly Pizza에서 검색합니다
import_asset	찾은 에셋을 씬으로 가져옵니다
generate_3d	Hyper3D Rodin, Hunyuan3D, Meshy, Tripo로 텍스트나 이미지에서 모델 하나를 만듭니다
generate_gaussian_world	World Labs Gaussian splat 씬을 만듭니다. Blender 5.3 이상 필요
get_addon_status	Blender와 애드온 버전, 활성화된 라이브러리와 생성기를 보여줍니다
disable_telemetry	데이터 수집을 끕니다
record_trajectory_feedback	세션에 대한 피드백을 보냅니다. 옵트인한 경우에만 동작합니다

이 서버를 쓸모 있게 만드는 조합은 execute_blender_code와 look입니다. 코드만 작성할 수 있는 모델은 추측에 불과합니다. 뷰포트를 렌더링해서 의자가 바닥 위 30 cm에 떠 있는 것을 볼 수 있는 모델이라면 고칠 수 있습니다. Poly Haven은 키가 필요 없고 에셋은 CC0입니다. Poly Pizza는 무료 키가 필요하며 모델의 약 3분의 2가 CC-BY이므로 저자에게 출처를 표시해야 합니다. 생성기들은 자체 API 키가 필요하거나, README에서 링크하는 유료 Premium 플랜이 필요합니다.

설치하기

Blender 3.0 이상, Python 3.10 이상, uv가 필요합니다. uv는 공식 설치 프로그램이나 brew install uv로 설치합니다. README에서는 pip install uv를 쓰지 말라고 합니다.

이 프로젝트는 웹사이트의 스크립트를 셸로 파이프하는 한 줄 설치 프로그램을 제공합니다. 동작은 하지만, 이런 방식을 조금이라도 쓴다면 먼저 스크립트를 읽어 보십시오. 수동 방식은 명령 두 개와 체크박스 하나입니다. 먼저 애드온입니다:

uvx mcp-for-blender install-addon

이 명령은 blender_mcp.py를 Blender의 애드온 폴더로 복사하고 경로를 출력합니다. 그다음 Blender를 열고 Edit, Preferences, Add-ons로 가서 "Interface: MCP for Blender"를 활성화합니다. 3D 뷰에서 N을 누르고 MCP for Blender 탭을 엽니다. 서버가 실행 중이어야 합니다. 패널에 시작 버튼이 있으면 클릭합니다. README는 두 섹션에서 이 버튼을 서로 다른 이름으로 부르므로, 사용 중인 버전에 표시되는 이름을 찾으십시오.

그다음 클라이언트에 서버를 추가합니다.

Claude Code

claude mcp add blender uvx mcp-for-blender

Codex

codex mcp add blender -- uvx mcp-for-blender

Claude Desktop과 Cursor는 같은 JSON을 사용합니다. Claude Desktop에서는 claude_desktop_config.json(Settings, Developer, Edit Config)에, Cursor에서는 Settings, MCP 또는 .cursor/mcp.json에 넣습니다:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"],
      "env": { "DISABLE_TELEMETRY": "true" }
    }
  }
}

Windows에서 Cursor는 "command": "cmd"와 "args": ["/c", "uvx", "mcp-for-blender"]가 필요합니다. env 줄은 선택 사항입니다. 아래에 설명하는 텔레메트리 기본값 때문에 넣어 두었습니다. 여러 클라이언트에 같은 항목을 한 번에 넣고 싶다면 config builder가 각 클라이언트용으로 작성해 줍니다.

터미널에서 uvx mcp-for-blender를 직접 실행하지 마십시오. 서버는 클라이언트가 시작합니다. 두 번째 사본은 같은 Blender를 두고 경쟁하며, 이슈 52에서 메인테이너는 한 곳 이상에서 실행하면 동작하지 않는다고 답했습니다.

Blender가 꺼져 있을 때 확인한 것

Blender를 실행하지 않은 상태에서 MCP Inspector로 서버를 시작했습니다. 서버는 올라왔고, 디스크의 애드온을 확인한 뒤("Blender addon on disk is current (protocol 16)") Failed to connect to Blender: [Errno 61] Connection refused를 로그에 남겼습니다. 도구 나열은 여전히 동작했습니다. 목록은 Blender가 필요 없기 때문입니다.

get_scene_info를 호출하니 "Could not connect to Blender. Make sure the Blender addon is running."라는 텍스트가 isError가 false인 채로 반환되었습니다. 이 세부 사항은 검사를 스크립트로 작성할 때 중요합니다. Inspector CLI가 0으로 종료되었으므로 CI 단계에서는 이 실패를 성공으로 읽게 됩니다. 종료 코드만이 아니라 결과의 텍스트를 확인하십시오.

Blender Lab의 공식 서버

Blender Lab은 Blender 프로젝트 안에서 새로운 시도를 하는 공간으로, 2026년 2월에 만들어졌습니다. MCP server는 projects.blender.org/lab/blender_mcp에 있고, blender.org에도 관련 페이지가 있습니다. Anthropic이 2026년 4월 28일 창작 작업용 커넥터를 발표했을 때, Blender 개발자들이 만든 MCP 커넥터가 이제 Claude에서 공식적으로 사용 가능하다고 밝혔습니다. Blender는 Anthropic의 기여를 Development Fund를 통하지 않고 일회성 기부로 받기로 했습니다.

26개의 도구는 쓰기보다 읽기 작업이 많습니다. .blend 파일의 데이터블록, 누락된 파일, 링크된 라이브러리와 경로에 대한 요약, 오브젝트 요약, 창이나 영역의 스크린샷, 인터페이스를 특정 탭이나 오브젝트로 이동시키는 도구, 파일로 저장하는 썸네일 및 뷰포트 렌더, 그리고 서버에 포함된 Blender Python API 문서와 매뉴얼 검색이 있습니다. 여러 파일 도구에는 별도의 백그라운드 Blender에서 실행되는 _for_cli 쌍둥이 도구가 있어, 모델이 열려 있지 않은 파일도 검사할 수 있습니다. execute_blender_code도 있어서 변경 작업도 할 수 있습니다.

설치하기

애드온은 Blender 5.1 이상이 필요합니다. blender.org와 애드온 매니페스트에 그렇게 나와 있습니다. Anthropic의 Claude Academy 튜토리얼에는 4.2라고 되어 있는데, 오래된 정보로 보입니다. blender.org 페이지의 링크를 Blender로 두 번 끌어다 놓으면 애드온이 설치됩니다. 첫 번째 드롭에서 "lab" 확장 저장소가 추가되고, 두 번째 드롭에서 설치됩니다. 그다음 Edit, Preferences, Add-ons로 이동해 해당 탭을 열고 MCP server를 시작합니다. 여기에서 자동 시작을 선택할 수 있습니다.

Claude Desktop에서는 직접 설정할 필요가 없습니다. Customize, Connectors를 열고 Blender를 검색해 추가하면 됩니다. Blender가 같은 머신에서 실행되어야 하므로 브라우저의 claude.ai가 아니라 Claude Desktop에서만 가능합니다. Academy 페이지에는 무료 플랜에서도 작동한다고 나와 있습니다.

다른 클라이언트의 경우 릴리스 페이지에 .mcpb 번들이 있거나, 저장소를 클론한 뒤 uv로 클라이언트가 해당 저장소를 가리키도록 설정합니다:

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["--directory", "/Users/you/blender_mcp/mcp", "run", "blender-mcp"]
    }
  }
}

애드온은 localhost 포트 9876에서도 수신합니다. 두 애드온을 모두 활성화한 경우 한 번에 하나만 시작하거나, 환경설정에서 하나를 다른 포트로 옮기십시오.

안전성: 두 프로젝트가 말하는 것

두 서버 모두 모델에게 Blender 내부의 Python 인터프리터를 넘겨줍니다. Blender의 Python은 사용자 계정과 동일한 권한으로 파일을 읽고 삭제하며, 네트워크 연결을 열고 프로그램을 실행할 수 있습니다. 어느 프로젝트도 이 점을 숨기지 않습니다.

MCP for Blender의 README는 execute_blender_code가 "강력할 수 있지만 잠재적으로 위험하다"고 밝히며, 굵은 글씨로 항상 먼저 작업을 저장하라고 안내합니다. 또한 애드온의 소켓에는 인증이나 암호화가 없어, 포트에 접근할 수 있는 사람이라면 누구나 여러분의 Blender에서 Python을 실행할 수 있다고 설명합니다. Blender Lab의 페이지는 더 나아가, 생성된 코드가 "어떤 보호 장치도 없이" 실행된다고 말하며 민감한 데이터가 없는 가상 머신이나 시스템을 권장합니다.

실제로 우리가 할 일은 다음과 같습니다.

• 저장하고, 버전을 남기십시오. 변경은 실행 중인 세션에서 일어납니다. 저장하기 전까지는 디스크에 아무것도 기록되지 않으므로, 잘못된 스크립트가 저장하지 않은 한 시간의 작업을 망가뜨릴 수도 있습니다. Preferences, Save & Load의 Save Versions 설정은 값싼 보험입니다.
• MCP for Blender에서 안전 모드를 켜십시오. 서버의 env에 BLENDER_MCP_SAFE_MODE=1을 설정합니다. 스크립트는 실행 전에 검사되며, 파일 접근, 다른 프로그램, 네트워크 접근, 지속성은 차단됩니다. 기본값은 꺼짐이며, 일부 에셋 워크플로에서는 꺼야 합니다.
• 소켓은 localhost에 두십시오. 애드온에는 "Bind Address"와 "Allow Remote Connections" 설정이 있습니다. 그대로 두고, 원격 Blender라면 SSH 터널을 사용하십시오.
• 코드를 보여 달라고 요청하십시오. 객체를 대량으로 삭제하거나 이름을 바꾸는 작업이라면, 모델에게 실행 전에 스크립트를 보여 달라고 요청하십시오. Anthropic의 튜토리얼도 같은 방식을 권장합니다.
• 텔레메트리 기본값을 확인하십시오. MCP for Blender는 기본적으로 도구 호출마다 최소한의 익명 기록을 전송합니다. 무작위 설치 및 세션 ID, 도구 이름, 성공 여부, 소요 시간, 버전, OS, 시간입니다. 프롬프트, 코드, 스크린샷, 장면 데이터는 동의 체크박스를 선택한 경우에만 전송되며, README는 동의한 데이터가 AI 모델 학습에 사용될 수 있다고 밝힙니다. DISABLE_TELEMETRY=true로 모든 것을 끌 수 있습니다.

로컬 MCP 서버가 무엇에 접근할 수 있는지 더 넓은 그림은 MCP 보안을 참고하십시오.

연결되지 않을 때

Blender MCP 문제는 거의 대부분 클라이언트에서 Blender로 이어지는 체인에서 발생하는 네 가지 단절 중 하나입니다. 순서대로 확인합니다.

보이는 증상	원인	해결
클라이언트 로그의 spawn uvx ENOENT	Dock이나 시작 메뉴에서 실행한 앱은 터미널의 PATH를 받지 못합니다	which uvx로 확인한 전체 경로(예: /opt/homebrew/bin/uvx)를 command로 사용하거나 Windows에서는 cmd /c uvx를 사용한 뒤, 클라이언트를 완전히 종료하고 다시 엽니다
"Could not connect to Blender", 로그에 Connection refused	Blender가 닫혔거나, 애드온이 비활성화되었거나, 서버가 시작되지 않았습니다	Blender를 열고 애드온을 활성화한 뒤 N 패널에서 서버를 시작합니다
도구가 무작위로 실패하거나 연결이 끊깁니다	서버 사본이 두 개 이상입니다. issue 52의 한 사용자는 Claude Desktop만 시작했는데 네 개를 발견했습니다	한 클라이언트에서만 유지하거나 나머지를 닫습니다. 남아 있는 mcp-for-blender 프로세스가 있는지 확인합니다
서버가 시작 시 Python 오류로 크래시합니다	conda나 pyenv의 Python이 잡혔거나, wheel이 없는 새 CPython입니다	args에서 패키지 이름 앞에 "--python", "3.11"을 추가하고 env에 "UV_PYTHON_PREFERENCE": "only-managed"를 추가합니다
업데이트 후 이전 동작이 나타납니다	uv 캐시	uv cache clean mcp-for-blender blender-mcp를 실행한 뒤 uvx --refresh mcp-for-blender를 실행합니다
Docker나 dev container의 서버가 Blender에 접근하지 못합니다	컨테이너 안의 localhost는 컨테이너 자신입니다	macOS와 Windows에서는 BLENDER_HOST=host.docker.internal을 설정하고, Linux에서는 --network=host를 사용합니다
가져오는 동안 Blender가 멈춥니다	Poly Haven 다운로드가 Blender의 메인 스레드에서 실행됩니다	기다립니다. 다운로드가 끝나면 돌아옵니다
Blender 창이 두 개인데 하나는 무시됩니다	두 애드온이 모두 9876을 사용합니다	두 번째 애드온에 다른 포트를 지정하고 --port로 두 번째 서버를 시작합니다

README에는 연결 후 첫 번째 명령이 실패하고 두 번째는 동작하는 경우가 있다고 나와 있습니다. 계속 실패하면 다른 것을 바꾸기 전에 클라이언트와 Blender의 서버를 모두 재시작합니다.

Other Blender MCP servers

포크가 상당히 많습니다. 2026년 11월 14일 GitHub에서 MCP for Blender 이후 실제 이력이 있는 것은 dhakalnirajan/blender-open-mcp(스타 123개, MIT)로, Ollama, LM Studio 또는 llama.cpp를 통한 로컬 모델용으로 만들어졌고 같은 애드온 포트를 사용합니다. 그다음으로 pranav-deshmukh/blender-mcp(스타 99개, MIT, 마지막 푸시 2025년 8월)와 bpy-dev/blender-mcp(스타 97개, GPL-3.0)가 있으며, 후자는 Blender Lab의 서버를 다시 패키징한 것입니다.

이름이 거의 같고 각각 스타가 약 200개인 저장소 그룹은 제외했습니다. 모두 2026년 11월 12일에 푸시되었고 그중 하나는 같은 날 생성되었습니다. 이틀 만에 나타난 스타 수는 구매한 것으로 보이며, 애드온은 Blender 내부에서 코드를 실행합니다. Blender MCP 프로젝트가 새로 보이면 설치 전에 커밋 이력과 기여자를 확인하십시오.

Blender를 언급하는 서버의 전체 목록은 검사 점수와 설치 명령과 함께 이 페이지 상단의 표에 있습니다.

무엇을 설치할지

• 어떤 클라이언트에서든 에이전트가 씬을 만들거나 수정하길 원한다면: MCP for Blender를 사용합니다. 어떤 워크플로에 안전 모드를 꺼야 하는지 파악한 뒤 안전 모드를 켜십시오.
• Claude Desktop을 사용하고 주로 파일이나 API에 대한 답변을 원한다면: 공식 Blender 커넥터를 사용합니다. 두 번의 클릭이면 되고, 문서 검색이 답변을 Blender의 실제 API에 묶어 둡니다.
• 로컬 모델을 실행한다면: blender-open-mcp를 사용하거나, 로컬 백엔드를 지원하는 클라이언트에서 MCP for Blender를 사용합니다.
• Blender 5.1보다 오래된 버전을 사용한다면: 둘 중 MCP for Blender만 로드됩니다.

무엇을 선택하든 첫 번째로 유용한 프롬프트는 같습니다. 모델에게 무엇이든 바꾸기 전에 씬을 설명해 달라고 요청하십시오. 모델이 그렇게 할 수 있다면 전체 체인이 작동합니다.