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 --version
Python이 설치되어 있지 않다면 Python 공식 사이트에서 다운로드하여 설치하세요.
2단계: 저장소 클론 또는 다운로드
git clone https://github.com/yourusername/BlenderMCP.git
cd BlenderMCP
또는 ZIP 파일로 다운로드하여 압축 해제하세요.
3단계: 자동 설치 실행
install.bat
이 스크립트는 자동으로:
- Python 패키지 설치 (
mcp,pydantic) - Blender 경로 확인
- 설치 완료 안내
4단계: Claude Desktop 설정
4-1. 설정 파일 위치
Claude Desktop 설정 파일을 엽니다:
%APPDATA%\Claude\claude_desktop_config.json
탐색기 주소창에 위 경로를 붙여넣으면 파일을 찾을 수 있습니다.
4-2. 설정 추가
claude_desktop_config.json 파일을 메모장으로 열고 다음 내용을 추가:
{
"mcpServers": {
"blender": {
"command": "python",
"args": [
"C:\\Users\\YourUsername\\BlenderMCP\\blender_mcp_server.py"
],
"env": {
"BLENDER_PATH": "C:\\Program Files\\Blender Foundation\\Blender 5.0\\blender.exe"
}
}
}
}
⚠️ 중요:
C:\\Users\\YourUsername\\BlenderMCP\\blender_mcp_server.py를 실제 설치 경로로 변경하세요- 블렌더 설치 경로가 다르다면
BLENDER_PATH도 수정하세요 - Windows 경로는 백슬래시를 두 번(
\\) 사용해야 합니다
4-3. Claude Desktop 재시작
Claude Desktop을 완전히 종료하고 다시 실행하세요.
🎨 사용 가능한 기능
MCP 서버가 제공하는 Blender 제어 도구:
1. create_cube - 큐브 생성
블렌더에 큐브를 생성합니다.
- name: 오브젝트 이름
- location: [x, y, z] 위치
- size: 크기
2. create_sphere - 구 생성
블렌더에 UV 구를 생성합니다.
- name: 오브젝트 이름
- location: [x, y, z] 위치
- radius: 반지름
- subdivisions: 세분화 수
3. execute_python - Python 코드 실행
블렌더에서 임의의 Python 코드를 실행합니다.
- code: 실행할 Python 코드
- background: 백그라운드 모드 (기본: true)
4. render_scene - 씬 렌더링
현재 블렌더 씬을 이미지로 렌더링합니다.
- output_path: 출력 파일 경로
- resolution_x: 가로 해상도 (기본: 1920)
- resolution_y: 세로 해상도 (기본: 1080)
- samples: 렌더 샘플 수 (기본: 128)
5. save_blend_file - .blend 파일 저장
현재 씬을 .blend 파일로 저장합니다.
- filepath: 저장 경로
6. get_blender_info - 블렌더 정보 확인
블렌더 버전 및 설치 정보를 가져옵니다.
7. list_objects - 오브젝트 목록
현재 씬의 모든 오브젝트를 나열합니다.
8. delete_object - 오브젝트 삭제
이름으로 오브젝트를 삭제합니다.
- name: 삭제할 오브젝트 이름
💡 사용 예시
Claude Desktop에서 다음과 같이 요청할 수 있습니다:
"블렌더에 큐브를 (0, 0, 0) 위치에 만들어줘"
"블렌더에 반지름 2인 구를 (2, 0, 0) 위치에 생성해줘"
"블렌더 씬에 있는 모든 오브젝트 목록을 보여줘"
"현재 씬을 C:\temp\output.png 로 렌더링해줘"
"블렌더에서 'import bpy; bpy.ops.mesh.primitive_cylinder_add()' 실행해줘"
🔧 문제 해결
MCP 서버가 연결되지 않을 때
- Claude Desktop을 완전히 재시작
- 설정 파일 경로가 올바른지 확인
- Python 패키지가 설치되었는지 확인:
pip list | findstr mcp
Blender 경로 오류
환경 변수를 확인하거나 시스템 환경 변수에 직접 추가:
setx BLENDER_PATH "C:\Program Files\Blender Foundation\Blender 5.0\blender.exe"
Python 실행 오류
blender_mcp_server.py 파일을 직접 실행해서 오류 확인:
python blender_mcp_server.py
📁 프로젝트 구조
BlenderMCP/
├── blender_mcp_server.py # MCP 서버 메인 코드
├── package.json # 프로젝트 메타데이터
├── requirements.txt # Python 의존성
├── install.bat # 윈도우 설치 스크립트
├── mcp_config_example.json # Claude Desktop 설정 예시
├── .env.example # 환경 변수 예시
└── README.md # 이 파일
🤝 기여
이슈나 PR은 언제든 환영합니다!
📄 라이선스
MIT License