Which integrations are available for this server?

Enables high-quality image generation using Google's Gemini models, specifically Gemini 2.5 Flash Image and Gemini 3 Pro Image. Utilizes Google Cloud for API project management and billing, which is required to access Gemini's paid image generation services.

How do I use KOF Nano Banana MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@KOF Nano Banana MCP Server Generate a flat illustration of robots at 16:9 saved to assets/robots.png" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

KOF Nano Banana MCP Server 🍌

MCP server for Gemini native image generation (Nano Banana). Part of the KeepOnFirst Agentic Workflow.

English | 繁體中文

⚠️ Important: Billing Required

Note: The Gemini API Free Tier does NOT support image generation models. To use this MCP server, you must provide an API key from a Google Cloud project with billing enabled.

Features

Generate images using Gemini 2.5 Flash Image or Gemini 3 Pro Image
Process queue of prompt files with validation and dry-run support
YAML frontmatter support for prompt configuration
Cross-IDE compatible - works with any MCP-enabled client

Installation

Option 1: Use via npx (Recommended)

If you have published this package or use it locally:

{ "mcpServers": { "nanobanana": { "command": "npx", "args": ["-y", "@keeponfirst/kof-nanobanana-mcp"], "env": { "GEMINI_API_KEY": "your-api-key-here" } } } }

Option 2: Local Development

cd kof-nanobanana-mcp npm install npm run build

Then configure absolute path in your MCP config (see Configuration section).

Configuration

1. Get a Gemini API Key

Go to Google AI Studio
Create an API key
IMPORTANT: Ensure your project has billing enabled. These models are paid-only.

2. Add to MCP Config

Add to your MCP configuration file (e.g., ~/.gemini/antigravity/mcp_config.json):

{ "servers": { "nanobanana": { "command": "node", "args": ["/path/to/kof-nanobanana-mcp/dist/index.js"], "env": { "GEMINI_API_KEY": "your-api-key-here" } } } }

Tools

`nanobanana_generate_image`

Generate a single image.

Parameters:

Name	Type	Required	Description
`prompt`	string	✅	Image description (10-5000 chars)
`output_path`	string	✅	Path to save the image
`model`	string	❌	`gemini-2.5-flash-image` (default) or `gemini-3-pro-image-preview`
`aspect_ratio`	string	❌	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`
`overwrite`	boolean	❌	Overwrite existing file (default: false)

Example:

{ "prompt": "A modern flat illustration of three AI robots working together on code", "output_path": "assets/generated/workflow-hero.png", "model": "gemini-2.5-flash-image", "aspect_ratio": "16:9" }

`nanobanana_list_queue`

List and validate prompt files in the queue.

Parameters:

Name	Type	Required	Description
`queue_dir`	string	❌	Queue directory (default: `nanobanana/queue`)
`validate`	boolean	❌	Validate files (default: true)
`check_conflicts`	boolean	❌	Check if outputs exist (default: true)

`nanobanana_process_queue`

Batch process all prompt files.

Parameters:

Name	Type	Required	Description
`queue_dir`	string	❌	Queue directory (default: `nanobanana/queue`)
`validate_only`	boolean	❌	Only validate, no generation
`dry_run`	boolean	❌	Preview without API calls
`overwrite`	string	❌	`skip`, `overwrite`, or `rename`

Prompt File Format

Create .md files in nanobanana/queue/ with YAML frontmatter:

--- output_path: assets/generated/workflow-hero.png model: gemini-2.5-flash-image aspect_ratio: 16:9 overwrite: false --- # Workflow Hero Image Create a modern, sleek hero illustration showing three AI agents working together in a software development workflow. ## Style Guidelines - Style: Flat illustration with gradients - Color palette: Deep purple (#6B46C1) to blue (#3B82F6) - Background: Subtle gradient

Pricing Reference

Model	Price per Image
Gemini 2.5 Flash Image	~$0.039 (1024x1024)
Gemini 3 Pro Image (2K)	~$0.134
Gemini 3 Pro Image (4K)	~$0.24

License

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

KOF Nano Banana MCP Server

KOF Nano Banana MCP Server 🍌

⚠️ Important: Billing Required

Features

Installation

Option 1: Use via npx (Recommended)

Option 2: Local Development

Configuration

1. Get a Gemini API Key

2. Add to MCP Config

Tools

`nanobanana_generate_image`

`nanobanana_list_queue`

`nanobanana_process_queue`

Prompt File Format

Pricing Reference

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API