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