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 generateapi_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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file banana_mcp-1.0.2.tar.gz.
File metadata
- Download URL: banana_mcp-1.0.2.tar.gz
- Upload date:
- Size: 9.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cbe7e4bd6627964ba77d5e009c2215b9bd9315da641c8778e5be934dbc0512ed
|
|
| MD5 |
3fbbdd983cf67a26f7fb7c3df8f8db36
|
|
| BLAKE2b-256 |
108322ddea067f0c5e37408f5cbd31c1a82793ba9f079ab59f2a57f730c2639e
|
File details
Details for the file banana_mcp-1.0.2-py3-none-any.whl.
File metadata
- Download URL: banana_mcp-1.0.2-py3-none-any.whl
- Upload date:
- Size: 8.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0b4915cd94c9299fae11643e641c8049489e381b3c041d5e1e54aa703513f2d4
|
|
| MD5 |
e4354078353e9bcd7a56e69c05bdf691
|
|
| BLAKE2b-256 |
cef5e463ac2501dfdac773e1e39aca4d1e93077017ee80b2a32d996ade4542a2
|