# 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)
```bash
uvx gemini-mcp
```
### Using pip
```bash
pip install gemini-mcp
```
## Usage
### As MCP Server
Add to your MCP client configuration (e.g., Claude Desktop):
```json
{
"mcpServers": {
"gemini": {
"command": "uvx",
"args": ["gemini-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}
```
### Command Line
```bash
# 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](https://api.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:**
```json
{
"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
```bash
git clone https://github.com/yourusername/gemini-mcp
cd gemini-mcp
pip install -e .
```
### Testing
```bash
# 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "banana-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, gemini, image-generation, mcp, model-context-protocol",
"author": null,
"author_email": "SuperHuang <superhuang@example.com>",
"download_url": "https://files.pythonhosted.org/packages/0b/3b/d11d15bdf30f3a0e58c9d5cb5a5e0fb6ae1ea7c9d46528c55332b61ae063/banana_mcp-1.0.4.tar.gz",
"platform": null,
"description": "# Gemini MCP\n\nA Model Context Protocol (MCP) server for generating images using Gemini 2.5 Flash.\n\n## Features\n\n- \ud83c\udfa8 Generate images using Gemini 2.5 Flash model\n- \ud83d\ude80 Easy installation with `uvx gemini-mcp`\n- \ud83d\udd27 Compatible with Claude, Cursor, and other MCP clients\n- \ud83d\udee1\ufe0f Secure API key handling via environment variables\n- \u26a1 Fast streaming responses\n\n## Installation\n\n### Using uvx (recommended)\n\n```bash\nuvx gemini-mcp\n```\n\n### Using pip\n\n```bash\npip install gemini-mcp\n```\n\n## Usage\n\n### As MCP Server\n\nAdd to your MCP client configuration (e.g., Claude Desktop):\n\n```json\n{\n \"mcpServers\": {\n \"gemini\": {\n \"command\": \"uvx\",\n \"args\": [\"gemini-mcp\"],\n \"env\": {\n \"GEMINI_API_KEY\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n### Command Line\n\n```bash\n# Set your API key\nexport GEMINI_API_KEY=\"your-api-key-here\"\n\n# Run the MCP server\ngemini-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n- `GEMINI_API_KEY`: Your API key for the tu-zi.com service (required)\n\n### API Key\n\nYou can obtain an API key from [tu-zi.com](https://api.tu-zi.com). The key should have access to the `gemini-2.5-flash-image` model.\n\n## Tools\n\n### generate_image\n\nGenerate an image from a text prompt using Gemini 2.5 Flash.\n\n**Parameters:**\n- `prompt` (string, required): Detailed description of the image to generate\n- `api_key` (string, optional): API key override (uses environment variable if not provided)\n\n**Example:**\n```json\n{\n \"name\": \"generate_image\",\n \"arguments\": {\n \"prompt\": \"A cute orange cat sitting under a cherry blossom tree, anime style, soft lighting\"\n }\n}\n```\n\n## Examples\n\n### Using with Claude\n\n```\nPlease use the generate_image tool to create a picture of a futuristic city at night with neon lights and flying cars.\n```\n\n### Using with Cursor\n\n```\nGenerate an image: minimalist office design with natural lighting and plants\n```\n\n## Development\n\n### Local Development\n\n```bash\ngit clone https://github.com/yourusername/gemini-mcp\ncd gemini-mcp\npip install -e .\n```\n\n### Testing\n\n```bash\n# Test the server\npython -m gemini_mcp.server\n\n# Or use the command directly\ngemini-mcp\n```\n\n## License\n\nMIT License\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Banana MCP - Gemini 2.5 Flash image generation server",
"version": "1.0.4",
"project_urls": {
"Bug Reports": "https://github.com/yourusername/gemini-mcp/issues",
"Documentation": "https://github.com/yourusername/gemini-mcp#readme",
"Homepage": "https://github.com/yourusername/gemini-mcp",
"Repository": "https://github.com/yourusername/gemini-mcp.git"
},
"split_keywords": [
"ai",
" gemini",
" image-generation",
" mcp",
" model-context-protocol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f3c0692c69cae8c696fecb278418fb10c8ecc12851bf9c17ecfe0e9288b53051",
"md5": "0d02f82fa283aa23d28c4d6026c3c83e",
"sha256": "072fc2a6788fa2b3b2de3b7675b345229e8abb705cf4a4e664b68c720645d4c2"
},
"downloads": -1,
"filename": "banana_mcp-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0d02f82fa283aa23d28c4d6026c3c83e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9316,
"upload_time": "2025-09-04T04:51:10",
"upload_time_iso_8601": "2025-09-04T04:51:10.027079Z",
"url": "https://files.pythonhosted.org/packages/f3/c0/692c69cae8c696fecb278418fb10c8ecc12851bf9c17ecfe0e9288b53051/banana_mcp-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0b3bd11d15bdf30f3a0e58c9d5cb5a5e0fb6ae1ea7c9d46528c55332b61ae063",
"md5": "efb0711616a46c0ccf82ce13cd211192",
"sha256": "a7207757f7436c74772680a31aae956e64ef05a7e56c68e0ecd5b78694624fa8"
},
"downloads": -1,
"filename": "banana_mcp-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "efb0711616a46c0ccf82ce13cd211192",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 10255,
"upload_time": "2025-09-04T04:51:11",
"upload_time_iso_8601": "2025-09-04T04:51:11.548570Z",
"url": "https://files.pythonhosted.org/packages/0b/3b/d11d15bdf30f3a0e58c9d5cb5a5e0fb6ae1ea7c9d46528c55332b61ae063/banana_mcp-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-04 04:51:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "gemini-mcp",
"github_not_found": true,
"lcname": "banana-mcp"
}
JSON
