mcp-imagenate
An MCP server for image generation using multiple providers: Google Gemini, OpenAI (gpt-image), and BFL FLUX.
Providers & Models
Google Gemini (Nano Banana)
| Name | Model ID | Best for |
|---|---|---|
nano-banana-2 | gemini-3.1-flash-image-preview | Fast, high-volume generation |
nano-banana-pro | gemini-3-pro-image-preview | Highest quality output |
OpenAI
| Name | Model ID | Best for |
|---|---|---|
gpt-image-1.5 | gpt-image-1.5 | High quality, prompt adherence |
BFL FLUX
| Name | Model ID | Best for |
|---|---|---|
flux-2-klein | klein-4b | Fast, lightweight generation |
flux-2-pro | pro-preview | Balanced quality and speed |
flux-2-max | max | Maximum quality |
Requirements
- Node.js 18+
- At least one provider API key
Installation
npx mcp-imagenate
Or install globally:
npm install -g mcp-imagenate
Setup
Set API keys for the providers you want to use:
# Google Gemini (at least one)
export GEMINI_API_KEY=your_key_here
# or
export NANO_BANANA_API_KEY=your_key_here
# OpenAI (at least one)
export OPENAI_API_KEY=your_key_here
# or
export GPT_IMAGE_API_KEY=your_key_here
# BFL FLUX
export BFL_API_KEY=your_key_here
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"mcp-imagenate": {
"command": "npx",
"args": ["mcp-imagenate"],
"env": {
"GEMINI_API_KEY": "your_key_here",
"NANO_BANANA_OUTPUT_DIR": "/path/to/image/output"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
GEMINI_API_KEY | * | Google AI Studio API key |
NANO_BANANA_API_KEY | * | Alternative to GEMINI_API_KEY (takes precedence) |
OPENAI_API_KEY | * | OpenAI API key |
GPT_IMAGE_API_KEY | * | Alternative to OPENAI_API_KEY (takes precedence) |
BFL_API_KEY | * | BFL FLUX API key |
NANO_BANANA_OUTPUT_DIR | No | Base directory for saved images. When set, all output and input paths are sandboxed within this directory. Recommended for production. |
* At least one provider API key must be set.
Tool: generate_image
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
prompt | string (1-32,000 chars) | - | Text prompt describing the image |
model | see Models above | "nano-banana-2" | Model to use (available models depend on configured API keys) |
resolution | "1K" | "2K" | "4K" | "1K" | Output image resolution |
aspectRatio | see below | "1:1" | Aspect ratio of the image |
mode | "image" | "image_and_text" | "image" | Return image only, or image with description (Google models only) |
thinking | "none" | "auto" | "auto" | Controls model thinking (Google models only) |
outputDir | string | "." | Directory where images will be saved |
inputImages | string[] | - | File paths of images to send alongside the prompt (Google models only) |
Supported aspect ratios
1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9
Response
Returns a JSON object:
{
"model": "gemini-3.1-flash-image-preview",
"savedFiles": ["/path/to/image-1.png"],
"settings": {
"resolution": "1K",
"aspectRatio": "9:16",
"mode": "image"
},
"description": "..."
}
descriptionis only present whenmodeis"image_and_text".
Security
- Path sandboxing: When
NANO_BANANA_OUTPUT_DIRis set, both output and input image paths are sandboxed within this directory. Symlinks that resolve outside the sandbox are rejected. - Input validation: Input images are validated for format (PNG/JPEG/WEBP/GIF) and size (max 20 MB).
- API key validation: The server exits immediately if no API keys are configured.
License
MIT