aliargun/mcp-server-gemini

A powerful MCP (Model Context Protocol) server that brings Google's latest Gemini AI models to your favorite development environment. Access Gemini 2.5's thinking capabilities, vision analysis, embeddings, and more through a seamless integration.
🚀 Works with: Claude Desktop, Cursor, Windsurf, and any MCP-compatible client
🎯 Why use this: Get Gemini's cutting-edge AI features directly in your IDE with full parameter control
📚 Self-documenting: Built-in help system means you never need to leave your editor
## Features
6 Powerful Tools: Text generation, image analysis, token counting, model listing, embeddings, and self-documenting help
Latest Gemini Models: Support for Gemini 2.5 series with thinking capabilities
Advanced Features: JSON mode, Google Search grounding, system instructions, conversation memory
Full MCP Protocol: Standard stdio communication for seamless integration with any MCP client
Self-Documenting: Built-in help system - no external docs needed
TypeScript & ESM: Modern, type-safe implementation
### Supported Models
| Model | Context | Features | Best For |
| gemini-2.5-pro | 2M tokens | Thinking, JSON, Grounding | Complex reasoning |
| gemini-2.5-flash ⭐ | 1M tokens | Thinking, JSON, Grounding | General use |
| gemini-2.5-flash-lite | 1M tokens | Thinking, JSON | Fast responses |
| gemini-2.0-flash | 1M tokens | JSON, Grounding | Standard tasks |
| gemini-1.5-pro | 2M tokens | JSON | Legacy support |
## Quick Start
1. Get Gemini API Key
Visit Google AI Studio
Create a new API key
IMPORTANT: Keep your API key secure and never commit it to version control
2. Configure Your MCP Client
Claude Desktop
Config location:
Mac: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
Linux: ~/.config/Claude/claudedesktopconfig.json
json
"mcpServers": {
"gemini": {
"type": "stdio",
"command": "npx",
"args": ["-y", "github:aliargun/mcp-server-gemini"],
"env": {
"GEMINIAPIKEY": "yourapikeyhere"
Cursor
Add to Cursor's MCP settings:
json
"gemini": {
"type": "stdio",
"command": "npx",
"args": ["-y", "github:aliargun/mcp-server-gemini"],
"env": {
"GEMINIAPIKEY": "yourapikeyhere"
Windsurf
Configure in Windsurf's MCP settings following their documentation.
Other MCP Clients
Use the standard MCP stdio configuration:
json
"type": "stdio",
"command": "npx",
"args": ["-y", "github:aliargun/mcp-server-gemini"],
"env": {
"GEMINIAPIKEY": "yourapikeyhere"
3. Restart Your MCP Client
## How to Use
Once configured, you can use natural language in your MCP client to access Gemini's capabilities:
### Basic Commands
"Use Gemini to explain quantum computing"
"Analyze this image with Gemini"
"List all Gemini models"
"Get help on using Gemini"
### Advanced Examples
"Use Gemini 2.5 Pro with temperature 0.3 to review this code"
"Use Gemini in JSON mode to extract key points with schema {title, summary, tags}"
"Use Gemini with grounding to research the latest in quantum computing"
📖 See the complete Usage Guide for detailed examples and advanced features.
## Why Gemini MCP Server?