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