Skip to main content

Banana MCP - Gemini 2.5 Flash image generation server

Project description

Gemini MCP

A Model Context Protocol (MCP) server for generating images using Gemini 2.5 Flash.

Features

  • 🎨 Generate images using Gemini 2.5 Flash model
  • 🚀 Easy installation with uvx gemini-mcp
  • 🔧 Compatible with Claude, Cursor, and other MCP clients
  • 🛡️ Secure API key handling via environment variables
  • ⚡ Fast streaming responses

Installation

Using uvx (recommended)

uvx gemini-mcp

Using pip

pip install gemini-mcp

Usage

As MCP Server

Add to your MCP client configuration (e.g., Claude Desktop):

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

Command Line

# Set your API key
export GEMINI_API_KEY="your-api-key-here"

# Run the MCP server
gemini-mcp

Configuration

Environment Variables

  • GEMINI_API_KEY: Your API key for the tu-zi.com service (required)

API Key

You can obtain an API key from tu-zi.com. The key should have access to the gemini-2.5-flash-image model.

Tools

generate_image

Generate an image from a text prompt using Gemini 2.5 Flash.

Parameters:

  • prompt (string, required): Detailed description of the image to generate
  • api_key (string, optional): API key override (uses environment variable if not provided)

Example:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A cute orange cat sitting under a cherry blossom tree, anime style, soft lighting"
  }
}

Examples

Using with Claude

Please use the generate_image tool to create a picture of a futuristic city at night with neon lights and flying cars.

Using with Cursor

Generate an image: minimalist office design with natural lighting and plants

Development

Local Development

git clone https://github.com/yourusername/gemini-mcp
cd gemini-mcp
pip install -e .

Testing

# Test the server
python -m gemini_mcp.server

# Or use the command directly
gemini-mcp

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

banana_mcp-1.0.1.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

banana_mcp-1.0.1-py3-none-any.whl (7.4 kB view details)

Uploaded Python 3

File details

Details for the file banana_mcp-1.0.1.tar.gz.

File metadata

  • Download URL: banana_mcp-1.0.1.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for banana_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 ce0922320c212de9fd475caa4a3720ae5644db9235c949aa8bc1c0eeb2918afa
MD5 dba1262118395cb3ff19fa9de066da04
BLAKE2b-256 d898a2726a43e8fa129c46fb4ce214248022c20e46da71f2f75a68d47188a09a

See more details on using hashes here.

File details

Details for the file banana_mcp-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: banana_mcp-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 7.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for banana_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ff6c6e3cd452189bf7d78e00211c56aca65a6c5adf595ebf2594336bb26966f5
MD5 845c5259984d650232444b64eb6f56e9
BLAKE2b-256 e31a9f951167aa35c340dd130f4df9978e5e7514acb35890070df0f936a0d00f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page