mcp-for-blender
애플리케이션ahujasid/mcp-for-blender
임의의 대규모 언어 모델이 Blender를 제어할 수 있게 하는 MCP 플러그인.
개요
커뮤니티에서 개발한 통합 도구로, 모델 컨텍스트 프로토콜(MCP)을 통해 Blender를 임의의 대규모 언어 모델과 연결합니다. Blender 플러그인과 Python MCP 서버를 포함하며, 프롬프트를 활용한 3D 모델링, 씬 생성, 오브젝트 및 머티리얼 조작, 코드 실행을 지원하고, Poly Haven, Sketchfab 등의 에셋과 AI로 생성된 3D 모델도 가져올 수 있습니다.
README 미리보기
\n\n# MCP for Blender\n\n**Connect Blender to any LLM**\n\n*formerly `blender-mcp` — the PyPI package is now [`mcp-for-blender`](https://pypi.org/project/mcp-for-blender/).*\n*Existing setups keep working; no config change is required. [Read more](https://github.com/ahujasid/mcp-for-blender/issues/366)*\n\n**Disclaimer:** This is a third-party integration and not made by Blender\n\nPrompt-assisted 3D modeling, scene creation, and manipulation — driven by AI.\n\n[](https://pepy.tech/projects/blender-mcp)\n[](https://pypi.org/project/mcp-for-blender/)\n[](LICENSE)\n[](https://discord.gg/SNqPn4TcKQ)\n\n[**Website**](https://mcp-for-blender.com/) · [**Full Tutorial**](https://www.youtube.com/watch?v=lCyQ717DuzQ) · [**Discord**](https://discord.gg/SNqPn4TcKQ) · [**Sponsor**](https://github.com/sponsors/ahujasid) · [**Buy me a coffee**](https://buymeacoffee.com/ahujasid) · [**Feedback**](https://cal.com/siddharth-ahuja/feedback-call)\n\n\n\n\n\n**Supporters**\n\n[CodeRabbit](https://www.coderabbit.ai/)\n[Kevin Guanche Darias](https://github.com/KevinGuancheDarias)\n[Guillermo Rauch](https://github.com/rauchg)\n\n**All supporters:** [Support this project](https://github.com/sponsors/ahujasid)\n\n\n\n---\n\n## Quickstart\n\n> **Note:** the PyPI package `blender-mcp` is now **`mcp-for-blender`**. Existing setups\n> keep working — `uvx blender-mcp` still runs the server and **no config change is\n> required**. New installs should use `mcp-for-blender`.\n> [What changed and why](https://github.com/ahujasid/mcp-for-blender/issues/366)\n\n**One command** sets up your AI apps and the Blender addon:\n\n**macOS / Linux**\n\n```bash\ncurl -LsSf https://www.mcp-for-blender.com/install.sh | sh\n```\n\n**Windows** (PowerShell)\n\n```powershell\npowershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"\n```\n\nAlready have uv? Run `uvx mcp-for-blender setup` instead.\n\nIt installs [uv](https://docs.astral.sh/uv/) if needed, finds the MCP clients on y
FAQ (3)
문제 해결독일어/비영어 Windows에서 'uvx mcp-for-blender setup' 실행 시 발생하는 UnicodeDecodeError 크래시를 해결하는 방법
크래시는 blender_is_running()에서 발생합니다. tasklist 출력이 OEM 코드 페이지(cp850)를 사용하는 반면 Python은 cp1252로 디코딩하기 때문에 'ü'와 같은 문자에서 실패하는 것이 원인입니다.
**수정 방법 (메인테이너/소스 설치의 경우):** blender_mcp/setup_cli.py의 약 607행에서 tasklist /FI "IMAGENAME eq blender.exe" /NH를 실행하는 subprocess.run 호출에 encoding="oem"(또는 errors="replace")을 전달하세요.
**사용자용 우회 방법:**
1. uvx mcp-for-blender setup을 실행하기 전에 chcp 65001을 실행하고 $env:PYTHONUTF8=1을 설정하세요 (PowerShell).
2. 또는 실패하는 단계를 건너뛰세요. 애드온 파일은 크래시 전에 이미 복사되어 있으므로, Blender를 열고 Edit > Preferences > Add-ons에서 애드온을 수동으로 활성화하기만 하면 됩니다.
문제 해결blender-mcp가 시작 시 'Successfully connected to Blender on startup' 이후 응답 없이 멈추는 이유는 무엇인가요?
멈춘 것이 아닙니다 — 이는 정상적인 동작입니다. uvx blender-mcp는 대화형 CLI가 아니라 stdio 기반 MCP 서버입니다. Blender에 연결된 후에는 MCP 클라이언트(Claude Desktop, Cursor 등)로부터 stdin/stdout을 통해 들어오는 MCP 프로토콜 메시지를 조용히 기다립니다. 터미널에서 직접 실행하는 것은 연결만 확인할 뿐이며, 이후 아무 출력도 표시되지 않고, Ctrl+C 트레이스백(asyncio CancelledError)은 오류가 아니라 정상적인 종료 과정에서 발생하는 메시지일 뿐입니다.
실제로 사용하려면:
1. Blender에서: Edit > Preferences > Add-ons로 이동하여 addon.py 파일을 설치하고 'Interface: Blender MCP'를 활성화합니다. 3D 뷰포트에서 N을 눌러 BlenderMCP 탭을 열고 'Connect to Claude'를 클릭합니다(포트 9876에서 소켓 서버가 시작됩니다).
2. 서버를 수동으로 실행하는 대신 MCP 클라이언트를 구성하세요. Claude Desktop의 경우 claude_desktop_config.json을 편집합니다:
{"mcpServers": {"blender": {"command": "uvx", "args": ["blender-mcp"]}}}
Cursor의 경우: Settings > MCP > Add new server에서 command에 uvx blender-mcp를 입력합니다.
3. 클라이언트를 재시작하고 그곳에서 프롬프트를 보내세요(예: 'create a cube in Blender') — 이제 Blender가 응답할 것입니다.
uvx blender-mcp는 연결 테스트 목적으로만 단독 실행하고, Ctrl+C로 종료하세요.
문제 해결Windows에서 uvx를 통해 blender-mcp를 실행할 때 발생하는 pywin32 'os error 32: file being used by another process' 오류를 해결하는 방법
이 오류는 uvx blender-mcp가 실행할 때마다 임시 환경을 생성하기 때문에 발생하며, uv 캐시에 잠긴 pywin32 파일을 교체할 수 없습니다. 대신 blender-mcp를 영구적인 uv 도구로 설치하여 해결하세요:
1. uv의 도구 저장소에 설치합니다: uv tool install blender-mcp
2. 강제로 업데이트합니다: uv tool upgrade blender-mcp
3. 설치를 확인합니다: uv tool list
MCP 구성은 그대로 유지할 수 있습니다 ("command": "uvx", "args": ["blender-mcp"]). 이제 uvx가 임시 환경을 다시 빌드하면서 파일 잠금에 부딪히는 대신 이미 설치된 도구를 확인하기 때문입니다. 잠긴 캐시 디렉터리(예: C:\Users\<you>\AppData\Local\uv\cache\builds-v0\...)를 수동으로 삭제하는 것만으로는 해결되지 않습니다. 다음 임시 설치 시 잠금이 다시 발생하기 때문입니다.