Metadata-Version: 2.4
Name: banana-mcp
Version: 1.0.3
Summary: Banana MCP - Gemini 2.5 Flash image generation server
Project-URL: Homepage, https://github.com/yourusername/gemini-mcp
Project-URL: Documentation, https://github.com/yourusername/gemini-mcp#readme
Project-URL: Repository, https://github.com/yourusername/gemini-mcp.git
Project-URL: Bug Reports, https://github.com/yourusername/gemini-mcp/issues
Author-email: SuperHuang <superhuang@example.com>
License: MIT
License-File: LICENSE
Keywords: ai,gemini,image-generation,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: anyio>=3.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# 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.