gemini-image-mcp

Gemini API를 활용한 이미지 생성/편집 도구. MCP 서버와 JS 모듈 두 가지 방식으로 사용 가능.

설치

cd gemini-image-mcp
npm install

API 키 설정

cp .env.example .env
# .env 파일에 실제 API 키 입력

사용법 1: MCP 서버 (Claude Code)

claude mcp add --transport stdio gemini-image -- node server.js

등록 후 Claude Code에서 자연어로 사용:

• "고양이 이미지 하나 생성해서 cat.png로 저장해줘"
• "cat.png에서 배경을 우주로 바꿔서 cat-space.png로 저장해줘"
• "이미지 편집 세션 시작해서 산 풍경 그려줘" → "호수 추가해줘"

MCP 도구 목록

도구	설명
generate_image	텍스트 → 이미지 생성
edit_image	기존 이미지 + 프롬프트 → 편집
start_image_session	멀티턴 편집 세션 시작
continue_image_session	세션 이어서 편집
get_image_config_info	설정 옵션 정보 확인

사용법 2: JS 모듈

import { generateImage, editImage, createSession } from './gemini-image.js';

// 이미지 생성
await generateImage('고양이', { output: './cat.png' });

// 이미지 편집
await editImage('./cat.png', '배경을 우주로', { output: './cat-space.png' });

// 멀티턴 세션
const session = createSession();
await session.send('산 풍경', { output: './v1.png' });
await session.send('호수 추가', { output: './v2.png' });
await session.sendWithImage('./photo.png', '스타일 변경', { output: './v3.png' });

설정 옵션

• aspectRatio: "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"
• imageSize: "1K" (기본), "2K", "4K"
• model: 기본 gemini-3-pro-image-preview
• 참고 문서: https://ai.google.dev/gemini-api/docs/image-generation?hl=ko