1. 개요
1.1. 문서 개요
- 이 문서는 <MCP Blender 연동 방법>에 관해 기록하는 문서입니다.
- Blender(블렌더)에 MCP(Model Context Protocol)를 적용하면 3D 모델링을 자동으로 생성할 수 있습니다.
2. 내용
2.1. 블렌더 설치
Download
저의 경우 블렌더 4.2.3인 LTS 버전을 설치하였습니다.
이 문서에서는 따로 설치 방법을 다루지 않습니다.
[[Blender 설치 방법]] 링크를 걸어둔 후 나중에 재설치 할 일이 있으면 업데이트 하도록 하겠습니다.
2.2. Powershell로 uv 설치
2.2.1. 기존 uv 삭제
만약 잘못된 기존 uv가 설치되어있다면 다음의 과정으로 삭제한 후 실행하면 정상적으로 설치됩니다.
우선 uv.exe 파일이 어디에 위치해있는지를 찾습니다.
Get-Command uv
다음의 명령어로 파일을 삭제합니다.
경로로 들어가 파일을 직접 삭제해도 됩니다.
Remove-Item "C:\Users\msm25\.local\bin\uv.exe"
캐시도 정리해줍니다.
Remove-Item "$env:USERPROFILE\.cache\uv" -Recurse -Force -ErrorAction SilentlyContinue
2.2.2. uv 설치
uv 설치 명령어는 여기에 나와있습니다.
파워셸 실행하여 다음과 같이 입력
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
다음과 같이 정상적으로 설치되는 것을 확인할 수 있습니다.
2.3. Claude mcp 설정
ctrl
+ ,
키를 눌러서 설정 창을 엽니다.
좌측에 개발자 탭을 선택 후 아래의 Edit Config 클릭
claude_desktop_config.json 파일을 메모장 같은 편집기로 엽니다.
blender mcp 서버만 등록할 경우 다음을 복사하여 붙여넣으면 됩니다.
출처
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
여러 mcp 서버를 등록할 경우 다음 경우와 같이 사용하고 있던 mcp에 콤마로 연결하여 붙여넣으면 됩니다.
{
"mcpServers": {
"obsidian-mcp-tools": {
"command": "C:\\Users\\user\\내 드라이브\\01_AI_Work\\.obsidian\\plugins\\mcp-tools\\bin\\mcp-server.exe",
"env": {
"OBSIDIAN_API_KEY": "3ed9d49288c0ec0ab4791d6bf9cbb5670acbab867a19dff7eb4ce02070b125d3"
}
},
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
이렇게 설정한 후 reload하기 위해 클로드를 한번 껐다가 켜줘야 합니다. 백그라운드에서 돌고 있는 클로드를 끄기 위해서는 다음과 같이 종료했다가 재실행해야 합니다.
재실행하면 blender mcp가 running 중인 것을 확인할 수 있습니다.
2.4. Blender 셋팅
2.4.1. addon.py 다운로드
https://github.com/ahujasid/blender-mcp/blob/main/addon.py
Download raw file 클릭하여 다운로드
2.4.2. blender 실행
블렌더 실행하여 Edit – Preferences 클릭
좌측의 Add-ons 탭에 들어가면 다음과 같은 창이 뜹니다.
우측 상단의 화살표 버튼 클릭 후 Install from Disk 클릭
다음과 같은 화면이 뜹니다.
여기서 아까 다운받은 addon.py 선택 후 Install from Disk 버튼 클릭
설치 완료 된 것을 확인할 수 있습니다.
단축키 n
입력
BlenderMCP 클릭
Connect to MCP server 클릭 하면 설정이 끝납니다.