# gemini-nano-banana-mcp

Minimal MCP server that generates images through Google's Gemini "Nano Banana"
image models (`gemini-2.5-flash-image` by default), using your own free
[Google AI Studio](https://aistudio.google.com/apikey) API key.

No third-party service, no paid credits — requests go straight to Google's
Gemini API.

## Setup

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

Get a free API key at https://aistudio.google.com/apikey.

## Register with Claude Code

```bash
claude mcp add gemini-image --scope user -e GEMINI_API_KEY=your-key-here -- node /absolute/path/to/gemini-nano-banana-mcp/dist/index.js
```

## Tool

### `generate_image`

| Argument       | Required | Description                                             |
| -------------- | -------- | --------------------------------------------------------- |
| `prompt`       | yes      | Text description of the image to generate                |
| `model`        | no       | Gemini image model id (default: `gemini-2.5-flash-image`) |
| `aspect_ratio` | no       | e.g. `1:1`, `16:9`, `9:16`                                 |
| `file_name`    | no       | Output file name (default: a timestamp)                   |

Generated images are saved to `OUTPUT_DIR` (default: `./output`) and the
tool returns the saved file path.

## Environment variables

| Variable         | Required | Default     |
| ----------------- | -------- | ----------- |
| `GEMINI_API_KEY`  | yes      | —           |
| `OUTPUT_DIR`      | no       | `./output`  |

## License

MIT