Initial commit: Gemini MCP Server

- MCP server implementation for Google Gemini models
- Support for multiple Gemini models including 1.5 Pro and 2.5 Pro preview
- Chat tool with configurable parameters (temperature, max_tokens, model)
- List models tool to view available Gemini models
- System prompt support
- Comprehensive error handling for blocked responses
- Test suite included
- Documentation and examples

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -0,0 +1,92 @@
+# Gemini MCP Server
+
+A Model Context Protocol (MCP) server that enables integration with Google's Gemini models, including Gemini 1.5 Pro and Gemini 2.5 Pro preview.
+
+## Features
+
+- **Chat with Gemini**: Send prompts to any available Gemini model
+- **List Models**: View all available Gemini models
+- **Configurable Parameters**: Adjust temperature, max tokens, and model selection
+- **System Prompts**: Support for system prompts to set context
+
+## Installation
+
+1. Clone this repository
+2. Create a virtual environment:
+   ```bash
+   python3 -m venv venv
+   source venv/bin/activate
+   ```
+3. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+## Configuration
+
+Set your Gemini API key as an environment variable:
+```bash
+export GEMINI_API_KEY="your-api-key-here"
+```
+
+## Usage
+
+### For Claude Desktop
+
+Add this configuration to your Claude Desktop config file:
+
+```json
+{
+  "mcpServers": {
+    "gemini": {
+      "command": "/path/to/venv/bin/python",
+      "args": ["/path/to/gemini_server.py"],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Direct Usage
+
+Run the server:
+```bash
+source venv/bin/activate
+export GEMINI_API_KEY="your-api-key-here"
+python gemini_server.py
+```
+
+## Available Tools
+
+### chat
+Send a prompt to Gemini and receive a response.
+
+Parameters:
+- `prompt` (required): The prompt to send to Gemini
+- `system_prompt` (optional): System prompt for context
+- `max_tokens` (optional): Maximum tokens in response (default: 4096)
+- `temperature` (optional): Temperature for randomness 0-1 (default: 0.7)
+- `model` (optional): Model to use (default: gemini-1.5-pro-latest)
+
+Available models include:
+- `gemini-1.5-pro-latest` - Latest stable Gemini 1.5 Pro
+- `gemini-1.5-flash` - Fast Gemini 1.5 Flash model
+- `gemini-2.5-pro-preview-06-05` - Gemini 2.5 Pro preview (may have restrictions)
+- `gemini-2.0-flash` - Gemini 2.0 Flash
+- And many more (use `list_models` to see all available)
+
+### list_models
+List all available Gemini models that support content generation.
+
+## Requirements
+
+- Python 3.8+
+- Valid Google Gemini API key
+
+## Notes
+
+- The Gemini 2.5 Pro preview models may have safety restrictions that block certain prompts
+- If a model returns a blocked response, the server will indicate the finish reason
+- For most reliable results, use `gemini-1.5-pro-latest` or `gemini-1.5-flash`