mcp server gemini

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

Features

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

Quick Start

1. Get Gemini API Key
2. Visit Google AI Studio

3. Create a new API key

4. Configure Claude Desktop

5. Locate your config file:

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

6. Add Gemini configuration:

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

7. Restart Claude Desktop

Documentation

• 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

Local Development

# 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

Contributing

Contributions are welcome! Please see our Contributing Guide.

Common Issues

1. Connection Issues
2. Check if port 3005 is available
3. Verify internet connection

4. See Troubleshooting Guide

5. API Key Problems

6. Verify API key is correct
7. Check permissions
8. See Setup Guide

Security

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

License

MIT