Gemini MCP Server

Google Gemini API를 사용하여 텍스트 생성·이미지 생성(Imagen)이 가능한 범용 MCP 서버입니다.

생성한 이미지는 로컬의 절대 경로로 반환합니다(이미지 데이터 자체는 도구 호출 결과에 포함하지 않습니다). 저장한 파일은 ftp-mcp의 ftp_upload_file에 전달하여 공개 URL로 만들고, wp-mcp의 wp_upload_media_from_url로 WordPress의 미디어 라이브러리에 등록하는 2단계 플로우의 전단계로 사용하는 것을 전제로 합니다. 텍스트 생성 결과는 그대로 도구 호출 결과로 반환합니다.

1. 셋업

cd gemini-mcp
npm install

config.json.example을 config.json에 복사하고, Google AI Studio(https://aistudio.google.com/apikey)에서 발급한 API 키를 입력합니다(이 파일에는 API 키가 들어 있으므로 절대 공개·공유·Git 커밋하지 마세요. .gitignore에 포함되어 있습니다).

cp config.json.example config.json

{
  "api_key": "AIza................................",
  "default_text_model": "gemini-2.5-flash",
  "default_image_model": "imagen-4.0-generate-001"
}

• api_key: Google AI Studio에서 발급한 API 키.

• default_text_model: generate_text의 model 파라미터를 생략했을 때 사용하는 모델 ID.

• default_image_model: generate_image의 model 파라미터를 생략했을 때 사용하는 모델 ID.

모델 라인업은 Google 공식 문서에서 수시로 업데이트되므로, 최신 모델 ID는 https://ai.google.dev/gemini-api/docs/models (텍스트) / https://ai.google.dev/gemini-api/docs/imagen (이미지) 에서 확인하세요.

API 키가 미설정(플레이스홀더 그대로)이어도 서버 자체는 시작할 수 있습니다. 실제로 generate_text / generate_image를 호출하는 시점에 Google 측 인증 오류가 발생합니다.

Related MCP server: MCP Nano Banana

2. Claude Code 등록

Claude Code를 사용하는 프로젝트의 루트 폴더에서 .mcp.json에 MCP 서버 정보를 추가합니다.

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/MCPの保存パス/gemini-mcp/index.js"],
      "env": {
        "GEMINI_MCP_CONFIG_PATH": "/MCPの保存パス/gemini-mcp/config.json"
      }
    }
  }
}

등록 후에는 Claude Code 세션을 재시작하여 MCP 서버를 다시 로드하세요.

3. 제공 도구

• gemini_check_config — API 키가 설정되어 있는지·기본 모델 이름을 확인합니다(API는 호출하지 않음).

• generate_text — 프롬프트에 대한 텍스트를 생성하고 그대로 반환합니다.

  • prompt(필수): 입력 프롬프트.

  • system_instruction(생략 가능): 모델 전체의 동작을 지정하는 시스템 지시.

  • temperature(생략 가능·0~2): 출력의 무작위성.

  • model(생략 가능): default_text_model을 덮어쓰는 모델 ID.

  • 반환값: 생성 모델 이름·생성 텍스트.

• generate_image — 텍스트 프롬프트에서 이미지를 생성하고 지정한 로컬 폴더에 PNG/JPEG로 저장합니다.

  • prompt(필수): 생성하려는 이미지의 설명.

  • output_dir(필수): 저장 대상 디렉터리의 절대 경로(존재하지 않으면 자동 생성).

  • file_prefix(생략 가능·기본값 image): 저장 파일 이름의 접두사.

  • number_of_images(생략 가능·기본값 1·최대 4): 생성 매수.

  • aspect_ratio(생략 가능·기본값 1:1): 1:1 / 3:4 / 4:3 / 9:16 / 16:9.

  • negative_prompt(생략 가능): 포함하고 싶지 않은 요소.

  • model(생략 가능): default_image_model을 덮어쓰는 모델 ID.

  • 반환값: 생성 모델 이름·프롬프트·저장된 각 파일의 절대 경로/MIME 타입 등.

보충

• 의존 라이브러리는 Google 공식 @google/genai SDK를 사용합니다.

• 안전 필터로 차단된 경우나 응답에 콘텐츠가 포함되지 않은 경우에는 오류로 반환합니다.

• 이미지 생성 용도(기사의 아이캐치·본문 삽입 이미지 등)나 기사 본문에 반영하는 절차는 docs/tasks/eyecatch-image.md / docs/tasks/image-embed.md(각 프로젝트 측)를 참조하세요.