# gemini-image-mcp

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

## 설치

```bash
cd gemini-image-mcp
npm install
```

## API 키 설정

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

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

```bash
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 모듈

```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