Gemini CLI를 사용한 Blender MCP 구성 - 완전한 설정 가이드

소개

Gemini CLI는 터미널에서 Google의 Gemini AI 모델과 직접 상호 작용할 수 있는 강력한 명령줄 인터페이스입니다. Blender MCP를 Gemini CLI와 통합하면 AI 기능을 활용하여 Blender 3D 모델링 워크플로우를 향상할 수 있습니다.

이 가이드는 Node.js 설치부터 MCP 서비스 검증까지 전체 설정 프로세스를 단계별로 안내합니다.

사전 요구 사항

Windows, macOS 또는 Linux 시스템
소프트웨어를 설치할 수 있는 관리자 권한
Gemini 액세스 권한이 있는 Google 계정
명령줄 인터페이스에 대한 기본 이해
시스템에 Blender 설치됨 (선택 사항이지만 권장)

1단계: Node.js 설치

Gemini CLI 및 Blender MCP 서버를 실행하려면 Node.js가 필요합니다. 다음 단계를 따라 설치하세요:

Windows의 경우:

nodejs.org방문
LTS(장기 지원) 버전 다운로드
설치 프로그램을 실행하고 설치 마법사를 따르세요
모든 기본 옵션 수락 (npm 및 PATH 구성 포함)
"완료"를 클릭하여 설치 완료

macOS의 경우:

Homebrew 사용: brew install node
또는 nodejs.org에서 다운로드하고 설치 프로그램 실행

Linux의 경우:

패키지 관리자를 사용하세요. 예를 들어 Ubuntu/Debian에서:

sudo apt update
sudo apt install nodejs npm

Node.js 설치 확인

터미널 또는 명령 프롬프트를 열고 다음을 실행하세요:

node --version
npm --version

Node.js가 올바르게 설치되면 두 명령 모두 버전 번호를 반환합니다.

2단계: Gemini CLI 다운로드 및 설치

Node.js가 설치되었으므로 이제 Gemini CLI를 다운로드하고 설정할 수 있습니다:

설치 단계

터미널 또는 명령 프롬프트 열기
Gemini CLI 프로젝트를 저장할 디렉토리로 이동하거나 새로 만들기 (gmcp라고 부르겠습니다)
디렉토리 생성:
```
mkdir gmcp
cd gmcp
```
npm을 사용하여 Gemini CLI 다운로드:
```
npm install -g @google/generative-ai-cli
```
또는 npx를 사용하여 전역 설치 없이 직접 실행:
```
npx @google/generative-ai-cli
```

3단계: Blender MCP 서비스 구성

MCP(Model Context Protocol) 서비스 구성은 Blender MCP를 Gemini CLI에 연결하는 핵심 단계입니다.

구성 파일 찾기

Gemini CLI는 설정을 설정 파일에 저장합니다. 위치는:

D:\seocode\tmp\gmcp\.gemini\settings.json

구성 추가

원하는 텍스트 편집기 (Visual Studio Code, Notepad++ 또는 Notepad 등)로 settings.json 파일을 열기

Blender MCP 서비스를 활성화하려면 다음 구성을 추가하거나 업데이트하세요:

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

구성 설명

mcpServers: 모든 MCP 서비스 정의를 포함하는 개체
blender: MCP 서비스의 이름 (Gemini CLI에서 식별하는 데 사용됨)
command: 실행할 명령 (uvx는 Python의 패키지 러너)
args: 명령에 전달되는 인수 (blender-mcp는 Blender MCP 패키지)

구성 저장

구성을 추가한 후 파일을 저장합니다. JSON이 올바르게 포맷되어 있고 후행 쉼표나 구문 오류가 없는지 확인하세요.

4단계: Gemini CLI 종료 및 다시 로그인

새로운 MCP 서비스 구성을 적용하려면 Gemini CLI를 다시 시작해야 합니다:

Gemini CLI 종료

Gemini CLI가 실행 중이면 다음을 입력하여 종료하세요:

exit

다시 로그인

터미널에서 Gemini CLI를 다시 시작하세요:

npx @google/generative-ai-cli

또는 전역으로 설치한 경우:

gemini-cli

5단계: MCP 서비스 구성 확인

Gemini CLI에 다시 로그인했으면 Blender MCP 서비스가 올바르게 구성되고 액세스 가능한지 확인하세요:

서비스 상태 확인

Gemini CLI에서 MCP 서비스가 로드되었음을 나타내는 출력이 표시되어야 합니다. 다음과 같은 메시지를 찾으세요:

[INFO] Loading MCP services...
[INFO] Blender MCP service loaded successfully
[INFO] Available tools: blender_create_object, blender_modify_object, ...

통합 테스트

Blender MCP 서비스를 사용하는 간단한 명령을 시도하세요. 예를 들어:

Blender에서 큐브 만들기

Blender가 MCP 플러그인과 함께 실행 중이면 Blender 장면에 큐브가 나타나야 합니다. Gemini는 요청을 처리하고 MCP 프로토콜을 통해 Blender에 명령을 보냅니다.

문제 해결

문제: Settings.json을 찾을 수 없음

해결책: 프로젝트 디렉토리에 .gemini 폴더를 수동으로 만들고 위에서 제공된 구성을 사용하여 settings.json 파일을 만드세요.

문제: "uvx 명령을 찾을 수 없음"

해결책: 필요한 Python 도구 패키지를 설치하세요:

pip install uv

문제: MCP 서비스가 로드되지 않음

해결책: 다음을 확인하세요:

settings.json의 JSON 구문이 올바른지 확인 (필요한 경우 JSON 유효성 검사기 사용)
파일 경로가 올바른지 확인: D:\seocode\tmp\gmcp\.gemini\settings.json
Blender MCP가 설치되어 있는지 확인: uvx blender-mcp --version
자세한 오류 메시지는 Gemini CLI 로그를 확인

문제: Blender가 명령에 응답하지 않음