Enables direct control over Blender to create 3D objects, execute Python scripts, render scenes, manage scene objects, and save .blend files.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BlenderMCPCreate a sphere at the origin and render the scene to C:\render.png"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BlenderMCP
Blender 5.0.1을 위한 MCP(Model Context Protocol) 서버 - Windows 10 지원
Claude Desktop에서 Blender를 직접 제어할 수 있게 해주는 MCP 서버입니다.
📋 요구사항
OS: Windows 10
Blender: 5.0.1 버전
Python: 3.8 이상
Claude Desktop: 최신 버전
🚀 설치 방법
1단계: Python 설치 확인
명령 프롬프트(CMD)에서 Python이 설치되어 있는지 확인:
Python이 설치되어 있지 않다면 Python 공식 사이트에서 다운로드하여 설치하세요.
2단계: 저장소 클론 또는 다운로드
또는 ZIP 파일로 다운로드하여 압축 해제하세요.
3단계: 자동 설치 실행
이 스크립트는 자동으로:
Python 패키지 설치 (
mcp,pydantic)Blender 경로 확인
설치 완료 안내
4단계: Claude Desktop 설정
4-1. 설정 파일 위치
Claude Desktop 설정 파일을 엽니다:
탐색기 주소창에 위 경로를 붙여넣으면 파일을 찾을 수 있습니다.
4-2. 설정 추가
claude_desktop_config.json 파일을 메모장으로 열고 다음 내용을 추가:
⚠️ 중요:
C:\\Users\\YourUsername\\BlenderMCP\\blender_mcp_server.py를 실제 설치 경로로 변경하세요블렌더 설치 경로가 다르다면
BLENDER_PATH도 수정하세요Windows 경로는 백슬래시를 두 번(
\\) 사용해야 합니다
4-3. Claude Desktop 재시작
Claude Desktop을 완전히 종료하고 다시 실행하세요.
🎨 사용 가능한 기능
MCP 서버가 제공하는 Blender 제어 도구:
1. create_cube - 큐브 생성
2. create_sphere - 구 생성
3. execute_python - Python 코드 실행
4. render_scene - 씬 렌더링
5. save_blend_file - .blend 파일 저장
6. get_blender_info - 블렌더 정보 확인
7. list_objects - 오브젝트 목록
8. delete_object - 오브젝트 삭제
💡 사용 예시
Claude Desktop에서 다음과 같이 요청할 수 있습니다:
🔧 문제 해결
MCP 서버가 연결되지 않을 때
Claude Desktop을 완전히 재시작
설정 파일 경로가 올바른지 확인
Python 패키지가 설치되었는지 확인:
pip list | findstr mcp
Blender 경로 오류
환경 변수를 확인하거나 시스템 환경 변수에 직접 추가:
Python 실행 오류
blender_mcp_server.py 파일을 직접 실행해서 오류 확인:
📁 프로젝트 구조
🤝 기여
이슈나 PR은 언제든 환영합니다!
📄 라이선스
MIT License