# Gemini Image MCP

A Model Context Protocol (MCP) server for AI image generation using Google's Gemini 3.0 models (Nano Banana Pro).

## Features

- **generate_image** - Create images from text prompts with up to 4K resolution
- **edit_image** - Modify existing images with instructions, style transfer, multi-image mixing
- **describe_image** - Analyze and describe images
- **Reference Images** - Support for up to 14 reference images for style/content guidance

## Installation

```bash
npm install
npm run build
```

## Configuration

### Claude Code CLI

```bash
claude mcp add gemini-image --env GEMINI_API_KEY=your_key -- node /path/to/dist/index.js
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gemini-image": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Zed Editor

<details>
<summary>Click to expand installation prompt for Zed</summary>

Copy and paste this prompt to your Zed AI assistant:

```
Install the gemini-image MCP server for me. Here's what you need to do:

1. Clone the repo and build it:
   git clone https://github.com/dfeirstein/gemini-image-mcp.git ~/.config/zed/mcp-servers/gemini-image-mcp
   cd ~/.config/zed/mcp-servers/gemini-image-mcp
   npm install
   npm run build

2. Add this to my Zed settings.json under "context_servers":
   {
     "context_servers": {
       "gemini-image": {
         "command": {
           "path": "node",
           "args": ["~/.config/zed/mcp-servers/gemini-image-mcp/dist/index.js"],
           "env": {
             "GEMINI_API_KEY": "YOUR_API_KEY_HERE"
           }
         }
       }
     }
   }

3. Remind me to replace YOUR_API_KEY_HERE with my actual Gemini API key from https://aistudio.google.com/apikey

The MCP provides three tools: generate_image, edit_image, and describe_image using Google's Gemini 3.0 (Nano Banana Pro) models.
```

</details>

## Get API Key

Get a Gemini API key from [Google AI Studio](https://aistudio.google.com/apikey).

**Note:** Gemini 3 Pro Image (Nano Banana Pro) requires billing enabled - no free tier.

## Usage Examples

### Generate Image
```
Generate a cyberpunk cityscape at night with neon lights
```

With high resolution:
```
Generate a detailed landscape at 4K resolution
```

### Edit Image
```
Add sunglasses to this photo
Remove the background
Apply a watercolor style
```

### Describe Image
```
What objects are in this image?
Describe the mood and composition
```

## Models

| Model | ID | Description |
|-------|-----|-------------|
| Nano Banana Pro | `gemini-3-pro-image-preview` | Best quality, up to 4K resolution (default) |
| Flash | `gemini-2.5-flash-preview-05-20` | Faster, good for descriptions |
| Legacy | `gemini-2.0-flash-exp` | Fallback option |

## Parameters

### Image Size (Nano Banana Pro)
- `1K` - Standard resolution (default)
- `2K` - High resolution
- `4K` - Ultra high resolution

### Aspect Ratio
- `1:1` - Square (default)
- `3:4` - Portrait
- `4:3` - Landscape
- `9:16` - Tall portrait
- `16:9` - Widescreen

## License

MIT