Claude Desktop용 Gemini MCP 서버

Claude Desktop이 Google의 Gemini AI 모델을 사용하여 이미지를 생성할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

🌟 특징

Google의 Gemini 모델을 사용하여 Claude Desktop에서 직접 이미지 생성
구성을 위한 간편한 설정 마법사
사용자 정의 가능한 이미지 생성 매개변수
Claude Desktop의 MCP 서버 시스템과 통합
자세한 로깅 및 디버깅 기능

📋 요구 사항

Node.js 16.x 이상
클로드 데스크톱 애플리케이션
Google Gemini API 키( 여기서 받으세요 )

🚀 설치

글로벌 설치(권장)

지엑스피1

로컬 설치

# Create a directory for the server
mkdir gemini-mcp-server
cd gemini-mcp-server

# Install locally
npm install gemini-mcp-server

# Run the setup wizard
npx gemini-mcp-setup

⚙️ 설정

설치 마법사가 구성 과정을 안내합니다.

Google Gemini API 키를 입력하세요
생성된 이미지를 저장할 디렉토리를 지정합니다.
로깅 및 모델 설정 구성
Claude Desktop에 대한 래퍼 스크립트를 자동으로 생성합니다.
Claude Desktop 구성을 업데이트하세요

수동 설정을 선호하는 경우 아래의 수동 구성 섹션을 참조하세요.

🎨 Gemini MCP 서버 사용

설치 및 구성이 완료되면 Claude Desktop을 다시 시작하여 Gemini MCP 서버를 활성화합니다. 그런 다음 다음을 수행합니다.

클로드와 대화를 시작하세요
예를 들어 Claude에게 다음과 같은 이미지를 생성해 달라고 요청하세요.
- "일몰 때의 산 풍경 이미지 생성"
- "비행 자동차가 있는 미래 도시의 그림을 만들어 보세요"
- "피아노를 치는 고양이 그림을 그려보세요"

Claude는 Gemini API를 호출하여 이미지를 생성하고 저장된 이미지 파일의 경로를 제공합니다.

고급 옵션

추가 매개변수를 사용하여 이미지 생성을 사용자 정의할 수 있습니다.

스타일 : "현실적", "예술적", "미니멀리즘" 등의 스타일을 지정합니다.
온도 : 생성의 창의성/무작위성을 제어합니다(0.0-1.0)

예: "온도 0.7의 현실적인 스타일로 네온 불빛이 있는 사이버펑크 도시 이미지를 생성하세요"

🔧 수동 구성

설치 마법사를 사용하지 않으려면 다음 단계를 따르세요.

1. 구성 파일 생성

설정을 사용하여 JSON 구성 파일을 만듭니다.

{
  "apiKey": "YOUR_GEMINI_API_KEY_HERE",
  "outputDir": "/path/to/your/output/directory",
  "debug": true,
  "modelOptions": {
    "model": "gemini-2.0-flash-exp",
    "temperature": 0.4
  }
}

2. 래퍼 스크립트 생성

서버를 실행하기 위한 bash 스크립트를 만듭니다.

#!/bin/bash
# Set environment variables
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE"
export OUTPUT_DIR="/path/to/your/output/directory"
export DEBUG="true"

# Execute the server
exec "$(which node)" "$(npm root -g)/gemini-mcp-server/bin/gemini-mcp-server.js"

스크립트를 실행 가능하게 만드세요:

chmod +x gemini-mcp-wrapper.sh

3. Claude 데스크톱 구성 업데이트

~/.config/claude/claude_desktop_config.json 파일을 편집하여 Gemini MCP 서버를 추가합니다.

{
  "mcpServers": {
    "gemini-image": {
      "command": "/bin/bash",
      "args": [
        "-c",
        "/path/to/your/gemini-mcp-wrapper.sh"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE",
        "DEBUG": "true"
      }
    }
  }
}

📚 API 문서

명령줄 인터페이스

gemini-mcp-server [options]

옵션:

-k, --api-key <key> : Google Gemini API 키
-o, --output-dir <dir> : 생성된 이미지를 저장할 디렉토리
-d, --debug : 디버그 로깅을 활성화합니다.
-c, --config <path> : 사용자 정의 구성 파일 경로
-r, --reset-config : 구성을 기본값으로 재설정합니다.
-v, --version : 버전 정보 표시

환경 변수

GEMINI_API_KEY : Google Gemini API 키
OUTPUT_DIR : 생성된 이미지를 저장할 디렉토리
DEBUG : 디버그 로깅 활성화( true 또는 false )
LOG_LEVEL : 로그 레벨 설정( ERROR , WARN , INFO 또는 DEBUG )
GEMINI_LOG_FILE : 사용자 정의 로그 파일 경로

구성 옵션

옵션	설명	기본
`apiKey`	Google Gemini API 키	(필수의)
`outputDir`	생성된 이미지를 저장할 디렉토리	`~/Claude/gemini-images`
`debug`	디버그 로깅 활성화	`false`
`modelOptions.model`	사용할 쌍둥이 모델	`gemini-2.0-flash-exp`
`modelOptions.temperature`	창의성/무작위성 제어	`0.4`
`modelOptions.topK`	Top-k 샘플링 매개변수	`32`
`modelOptions.topP`	Top-p 샘플링 매개변수	`1`
`modelOptions.maxOutputTokens`	최대 출력 토큰	`8192`

🔍 문제 해결

일반적인 문제

서버가 시작되지 않거나 Claude가 서버에 연결할 수 없습니다.

~/Claude/logs/gemini-image-mcp.log 에서 로그 파일을 확인하세요.
API 키가 올바른지 확인하세요
모든 디렉토리가 존재하고 적절한 권한이 있는지 확인하세요.
Claude Desktop을 다시 시작하세요

이미지가 생성되지 않습니다

Google Gemini API 키에 올바른 권한이 있는지 확인하세요.
출력 디렉토리가 존재하고 쓰기 가능한지 확인하세요
특정 오류 메시지에 대한 로그를 검사합니다.
다른 프롬프트나 모델을 시도해 보세요

오류: "메서드를 찾을 수 없습니다"

이는 일반적으로 Claude가 MCP 서버에서 지원하지 않는 메서드를 호출하려고 한다는 것을 의미합니다. 어떤 메서드가 요청되었는지 확인하려면 로그를 확인하세요.

디버그 모드

더 자세한 로그를 보려면 디버그 모드를 활성화하세요.

npx gemini-mcp-server --debug

또는 환경 변수를 설정합니다.

export DEBUG=true
npx gemini-mcp-server

📝 라이센스

MIT

🙏 감사의 말

MCP 사양을 위한 모델 컨텍스트 프로토콜
Gemini API를 위한 Google Generative AI
이 프로젝트에 기여한 모든 사람들

Gemini MCP Server for Claude Desktop

Integrations