Banana Image MCP

Let Claude Generate Stunning Images for You

中文文档 | Report Issues

What is Banana Image MCP?

Banana Image MCP is an MCP (Model Context Protocol) server that enables Claude and other AI assistants to generate high-quality images using Google's latest Gemini image models.

Simply describe what you want, and Claude will create it - from quick concept sketches to stunning 4K professional artwork.

Key Features

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 your config file:

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

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

# Clear the cache for this package
uv cache clean banana-image-mcp

# Then restart your MCP client (Claude Desktop, etc.)

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

3. Start Creating

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 YouTube thumbnail about cooking"

"Edit this image: make the sky more dramatic"

Models Comparison

Model Selection

The server defaults to Pro model for best quality. You can also control it:

Tool Parameters

Environment Variables

Example Outputs

Here are some examples of what you can create:

• Product Photography: Professional product shots with studio lighting
• Concept Art: Fantasy landscapes, character designs, sci-fi scenes
• Marketing Materials: Social media graphics, banners, thumbnails
• Technical Diagrams: Flowcharts, architecture diagrams with text
• Photo-realistic Images: Portraits, nature, urban photography

Development

# Clone the repository
git clone https://github.com/zengwenliang416/banana-image-mcp.git
cd banana-image-mcp

# Install dependencies
uv sync

# Run in development mode
fastmcp dev banana_image_mcp.server:create_app

# Run tests
pytest

# Lint and format
ruff check .
ruff format .

Changelog

v1.0.0

• First stable release
• 4K resolution output support (up to 3840px)
• Dual model support: Flash (fast) + Pro (4K quality)
• Intelligent model selection based on prompt
• Google Search grounding for Pro model
• Flexible aspect ratios (1:1, 16:9, 9:16, 4:3, 21:9, etc.)
• Image editing with natural language
• GitHub Actions CI/CD workflow

v0.1.2

• Added 4K resolution output support
• Default to Pro model and 4K resolution
• Fixed image_size parameter passing to Gemini API

v0.1.1

• Updated package metadata and author info

v0.1.0

• Initial release with dual model support

Links

• PyPI Package
• GitHub Repository
• Report Issues

License

MIT License - see LICENSE for details.