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%\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" } } } }
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

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