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-2	gpt-image-2	Latest generation, improved detail

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

... View full README on GitHub