Gemini MCP Server

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

   • Visit Google AI Studio
   • Create a new API key

2. Configure Claude Desktop

   • 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
     

   • Add Gemini configuration:

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

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

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

2. API Key Problems

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

Security

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

License

MIT