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.4.tar.gz (10.3 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.4-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: banana_mcp-1.0.4.tar.gz
  • Upload date:
  • Size: 10.3 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.4.tar.gz
Algorithm Hash digest
SHA256 a7207757f7436c74772680a31aae956e64ef05a7e56c68e0ecd5b78694624fa8
MD5 efb0711616a46c0ccf82ce13cd211192
BLAKE2b-256 0b3bd11d15bdf30f3a0e58c9d5cb5a5e0fb6ae1ea7c9d46528c55332b61ae063

See more details on using hashes here.

File details

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

File metadata

  • Download URL: banana_mcp-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 9.3 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 072fc2a6788fa2b3b2de3b7675b345229e8abb705cf4a4e664b68c720645d4c2
MD5 0d02f82fa283aa23d28c4d6026c3c83e
BLAKE2b-256 f3c0692c69cae8c696fecb278418fb10c8ecc12851bf9c17ecfe0e9288b53051

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