banana-image-mcp 0.1.2

A production-ready MCP server for AI-powered image generation using Gemini 3 Pro Image and Gemini 2.5 Flash Image with intelligent model selection

Banana Image MCP

Let Claude Generate Images for You

中文文档

---

What is this?

Banana Image MCP is an MCP server that gives Claude (and other AI assistants) the ability to generate images using Google's Gemini models.

Simply tell Claude what image you want, and it will create it for you - from quick sketches to professional 4K artwork.

Features

Feature	Description
Dual Model Support	Flash (fast, 2-3s) + Pro (4K quality, 5-8s)
Smart Auto-Selection	Automatically picks the best model for your needs
4K Resolution	Up to 3840px professional-grade output
Google Search Grounding	Pro model uses real-world knowledge for accuracy
Flexible Aspect Ratios	1:1, 16:9, 9:16, 21:9, and more
Image Editing	Edit existing images with AI

Quick Start

1. Get a Gemini API Key

Get your free API key from Google AI Studio

2. Install & Configure

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "banana-image": {
      "command": "uvx",
      "args": ["banana-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Config file location

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Other clients (Cursor, VS Code, etc.)

Cursor / VS Code Claude Extension:

{
  "mcpServers": {
    "banana-image": {
      "command": "uvx",
      "args": ["banana-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Start Using

Just ask Claude to generate images:

"Generate a cute cat wearing a space suit"

"Create a professional product photo of a coffee cup, 4K quality"

"Make a 16:9 thumbnail for my YouTube video about cooking"

Models

Model	Speed	Max Resolution	Best For
Flash	2-3s	1024px	Quick drafts, iterations, prototypes
Pro	5-8s	4K (3840px)	Final assets, marketing, professional work

The server automatically selects the best model, or you can specify:

• Say "quick sketch" or "draft" → Flash
• Say "4K", "professional", or "high quality" → Pro

Environment Variables

Variable	Required	Default	Description
GEMINI_API_KEY	Yes	-	Your Gemini API key
IMAGE_OUTPUT_DIR	No	~/banana-images	Where to save images

Links

• PyPI Package
• GitHub Repository
• Report Issues

---

Made by Wenliang Zeng

MIT License