Model Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.

• Full MCP protocol support
• Real-time response streaming
• Secure API key handling
• Configurable model parameters
• TypeScript implementation

1. Visit Google AI Studio
2. Create a new API key

Locate your config file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add Gemini configuration:

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "github:aliargun/mcp-server-gemini"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

• Claude Desktop Setup Guide - Detailed setup instructions
• Examples and Usage - Usage examples and advanced configuration
• Implementation Notes - Technical implementation details
• Development Guide - Guide for developers
• Troubleshooting Guide - Common issues and solutions

# Clone repository
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# Install dependencies
npm install

# Start development server
npm run dev

Contributions are welcome! Please see our Contributing Guide.

• Check if port 3005 is available
• Verify internet connection
• See Troubleshooting Guide

• Verify API key is correct
• Check permissions
• See Setup Guide

• API keys are handled via environment variables only
• No sensitive data is logged or stored
• Regular security updates

MIT