# 🎨 Gemini Image MCP Server

Claude.ai-ға Nano Banana (Gemini) арқылы сурет генерациясын қосатын custom MCP connector.

## Жылдам старт

### 1. GitHub-қа жүкте

```bash
git init
git add .
git commit -m "Gemini MCP Server"
gh repo create gemini-mcp-server --public --push
```

### 2. Deploy ет (таңда біреуін)

#### Опция А: Railway (ұсынылады)
1. https://railway.com → GitHub-пен кір
2. "New Project" → "Deploy from GitHub Repo"
3. Репозиторийді таңда
4. Variables бөліміне қос:
   - `GEMINI_API_KEY` = сенің key
   - `PORT` = 8080
   - `MCP_TRANSPORT` = sse
5. Deploy бас → URL аласың (мыс: `https://gemini-mcp-server-xxx.up.railway.app`)

#### Опция Б: Render (тегін)
1. https://render.com → GitHub-пен кір
2. "New Web Service" → Репозиторийді таңда
3. Environment variables қос:
   - `GEMINI_API_KEY` = сенің key
   - `PORT` = 8080
   - `MCP_TRANSPORT` = sse
4. Deploy бас → URL аласың

### 3. Claude.ai-ға қос

1. https://claude.ai/settings/connectors
2. "Add custom connector"
3. URL: `https://сенің-сервер-url/sse`
4. "Add" бас → дайын!

### 4. Қолдан

Claude.ai чатында жаз:

> "Қазақ даласында жылқы шапқан қыз, Pixar 3D стильде сурет жаса"

## Қолданылатын tool-дар

| Tool | Сипаттамасы |
|------|------------|
| `generate_image` | Промпт арқылы сурет генерациялау |
| `edit_image_prompt` | Промптты жақсарту |
| `list_models` | Қол жетімді модельдерді көрсету |

## Стильдер

- `photorealistic` — фотореалистік
- `illustration` — цифрлық иллюстрация
- `cartoon` — мультфильм стилі
- `3d_render` — 3D Pixar стилі (Storyara үшін!)
- `pixel_art` — пиксель арт
- `watercolor` — акварель
- `oil_painting` — май бояу

## Environment Variables

| Variable | Міндетті | Сипаттамасы |
|----------|---------|------------|
| `GEMINI_API_KEY` | Иә | Google AI Studio API key |
| `PORT` | Жоқ | Сервер порты (default: 8080) |
| `MCP_TRANSPORT` | Жоқ | `sse` немесе `streamable-http` (default: sse) |
| `GEMINI_IMAGE_MODEL` | Жоқ | Gemini model ID (default: gemini-2.0-flash-exp) |