blender-mcp + cursor 연동

이현성·2026년 6월 3일

blender blender-mcp cursor windows

💡 윈도우11 환경에서 진행합니다

0. 작성자 환경

1. cursor: 1.2.4

2. blender: 4.3.9 LTS

3. python: 3.13.5

4. 터미널에서 uv 설치

pip install uv

설치 후 혹시 모르니 아래 명령어로 확인도 해본다.

uvx --version

1. mcp.json

a. Cursor 설정에서 MCP 서버 추가

커서 세팅에서 위의 New MCP Server 버튼을 눌러 mcp.json 파일로 들어간다.

b. mcp.json 작성

하단과 같이 작성한다.

{
  "mcpServers": {
    "blender": {
      "command": "cmd",
      "args": ["/c", "uvx", "blender-mcp"]
    }
  }
}

만약 uvx가 바로 잘 잡히는 환경이라면 아래처럼 작성해도 된다.

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

작성하고 나면 아래처럼 blender 창이 활성화된다. (잠시 Loading tools가 나올 수 있음!)

2. blender

a. addon.py 다운로드

https://github.com/ahujasid/blender-mcp 접속하여 addon.py를 다운로드한다.

b. Add-ons 메뉴 진입

아래의 단계를 따라 Add-ons 메뉴로 진입한다.

Install from Disk로 아까 다운받은 파일을 선택하면 별표의 Blender MCP가 등장한다.

c. Start MCP Server 클릭

키보드 단축키 N을 누르면 오른쪽에 메뉴가 생기는데, 저기서 BlenderMCP를 클릭한다.

그리고 Start MCP Server를 클릭해보자!

3. 실행

Connect to MCP Server를 클릭하여 서버를 켜고, Cursor로 돌아와 아무 명령이나 한다.

세모 큐브라는 어정쩡한 질문을 던지긴 했는데, 저렇게 원뿔 모양으로 만들어줬다.

4. 시행착오......

아래의 레퍼런스가 너무너무 도움이 되었으나, 여기까지 따라왔다면 잠시 보고 지나가면 도움이 될 듯 하다.

1. cursor 및 blender의 관리자 권한

cursor 및 blender의 관리자 권한은 작성자에겐 상관 없었다.

그래도 환경에 따라 다를 수 있으니, 위처럼 했는데 안 되면 한 번쯤 시도해볼수도.

2. 연결 확인 방법

우선 블렌더에서 Toggle System Console 버튼을 누르면 터미널이 열린다.

이 상태에서 Connect to MCP Server를 실행하면

이렇게 연결이 시작된다고 나온다.

이 상태에서 윈도우 터미널로 가 아래의 명령어를 입력하면 연결을 확인할 수 있다!

3. port는 9876 그대로 놔두라고

아래의 Port 부분에 마우스를 올리면 이렇게 포트를 변경할 수 있다.

작성자는 처음에 이것저것 눌러보다가 저 포트를 9874로 교체하였는데 이것이 문제의 시작이었다...

9876이 default다. 다시 말하지만, 9876이 default다.

블렌더에서 9874로 바꾼 뒤,

인바운드 규칙에서 9874 허용도 해보고
mcp.json에서 args 자리에 port 옵션으로 9874도 넣어보고
Cursor도 껐다 켜보고
Blender도 껐다 켜보고

했는데 다 안됐다..

결국 다 필요 없었고, 기본 포트인 9876만이 정상적으로 연결됐다.

하 블렌더에서 포트를 바꿀 수 있는걸로 봐서 무언가 방법이 있을 줄 알았는데..

4. 인바운드 규칙

아래 레퍼런스 보고 쫄아서 blender와 cursor 앱 자체의 인바운드 규칙은 추가해놓았는데, 의미 있는지는 모르겠다.

혹시 위와 같이 했는데도 안된다면 시도해보자.

5. 참고

현재 3시 반... 죽고 싶..은건 아니고 누워버리고 싶다.
업로드중..
아직 오늘 작업이 다 안끝났다... 낼 QA 하기로 했는데 아무리 못해도 기능 자체는 다 끝내야 하지 않겠는가
대시보드 이슈가 그득그득할 것 같다 ㅠ

블로그도 이번 대시보드 내용 쓰려고 했는데 도ㅗㅗㅗㅗㅗㅗㅗ? 저히 시간이 안나서 쟁여놨던 옛날 블렌더 MCP 작업 내용 가져왔다.

이렇게 쟁여놓은 글이 몇 개 있는데, 사알짝 스포하자면 edge function이나 멀티부팅..?
그래그래 백엔드 OS 내용이다 이게 프론트야 백이야 풀스택이야 DB야

오늘 낮에 작업하다가 딜레이가 많이 되긴 했는데 그래도 술자리 한 10시 쯤 끝나면 어떻게 마무리 지을 수 있지 않을까 싶은건 착각이었다🥲

내 숙취 중 하나는 두통이라 복귀하자마자 약 4알 흡입하고 이게 또 수면 효과가 있어서 안그래도 졸리운데 더 졸립다.

아침에 못일어날 것 같은데 오랜만에 불 켜고 잘까 싶다.

이현성

이전 포스트

실시간 대시보드 전략 고민해보기

다음 포스트