Gemini MCP Server

Un servidor MCP para interactuar con los modelos de IA Gemini de Google, que requiere una clave de API de Gemini.

Documentación

Gemini MCP Server

Un potente servidor MCP (Model Context Protocol) que lleva los últimos modelos de IA Gemini de Google a tu entorno de desarrollo favorito. Accede a las capacidades de razonamiento de Gemini 2.5, análisis de visión, embeddings y más mediante una integración perfecta.

🚀 Funciona con: Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP
🎯 Por qué usarlo: Obtén las funciones de IA de vanguardia de Gemini directamente en tu IDE con control total de parámetros
📚 Autodocumentado: El sistema de ayuda integrado significa que nunca necesitas salir de tu editor

Características

6 Herramientas Potentes: Generación de texto, análisis de imágenes, conteo de tokens, listado de modelos, embeddings y ayuda autodocumentada
Últimos Modelos Gemini: Soporte para la serie Gemini 2.5 con capacidades de razonamiento
Funciones Avanzadas: Modo JSON, grounding con Google Search, instrucciones de sistema, memoria de conversación
Protocolo MCP Completo: Comunicación stdio estándar para una integración perfecta con cualquier cliente MCP
Autodocumentado: Sistema de ayuda integrado: no se necesitan documentos externos
TypeScript y ESM: Implementación moderna y segura de tipos

Modelos Compatibles

Modelo	Contexto	Funciones	Ideal Para
gemini-2.5-pro	2M tokens	Razonamiento, JSON, Grounding	Razonamiento complejo
gemini-2.5-flash ⭐	1M tokens	Razonamiento, JSON, Grounding	Uso general
gemini-2.5-flash-lite	1M tokens	Razonamiento, JSON	Respuestas rápidas
gemini-2.0-flash	1M tokens	JSON, Grounding	Tareas estándar
gemini-1.5-pro	2M tokens	JSON	Soporte heredado

Inicio Rápido

Obtén tu Clave API de Gemini
- Visita Google AI Studio
- Crea una nueva clave API
- IMPORTANTE: Mantén tu clave API segura y nunca la subas al control de versiones

Configura tu Cliente MCP

Claude Desktop

Ubicación de configuración:

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

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

Cursor

Añade a la configuración MCP de Cursor:

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

Windsurf

Configura en los ajustes MCP de Windsurf siguiendo su documentación.

Otros Clientes MCP

Usa la configuración estándar de MCP stdio:

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

Reinicia tu Cliente MCP

Cómo Usar

Una vez configurado, puedes usar lenguaje natural en tu cliente MCP para acceder a las capacidades de Gemini:

Comandos Básicos

"Use Gemini to explain quantum computing"
"Analyze this image with Gemini" 
"List all Gemini models"
"Get help on using Gemini"

Ejemplos Avanzados

"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"

📖 Consulta la Guía de Uso completa para ver ejemplos detallados y funciones avanzadas.

¿Por qué Gemini MCP Server?

Accede a los Últimos Modelos: Usa Gemini 2.5 con capacidades de razonamiento: los modelos más avanzados de Google
Conjunto Completo de Funciones: Todas las funciones de la API de Gemini, incluidos el modo JSON, grounding e instrucciones de sistema
Configuración Sencilla: Instalación con una línea de npx, sin necesidad de configuración compleja
Listo para Producción: Manejo integral de errores, tipos de TypeScript y documentación extensa
Desarrollo Activo: Actualizaciones periódicas con nuevas funciones de Gemini a medida que se publican

Documentación

Guía de Uso - Guía completa sobre el uso de todas las herramientas y funciones
Referencia de Parámetros - Documentación detallada de todos los parámetros
Referencia Rápida - Hoja de referencia rápida de comandos
Funciones Mejoradas - Lista detallada de las capacidades de v4.0.0
Guía de Configuración de Claude Desktop - Instrucciones detalladas de configuración
Ejemplos y Uso - Ejemplos de uso y configuración avanzada
Notas de Implementación - Detalles técnicos de implementación
Guía de Desarrollo - Guía para desarrolladores
Guía de Solución de Problemas - Problemas comunes y soluciones

Desarrollo Local

# Clone repository
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY

# Start development server
npm run dev

Contribuciones

¡Las contribuciones son bienvenidas! Consulta nuestra Guía de Contribución.

Problemas Comunes

Problemas de Conexión
- Asegúrate de que tu cliente MCP se haya reiniciado correctamente
- Revisa los registros del cliente (p. ej., ~/Library/Logs/Claude/mcp-server-gemini.log para Claude Desktop en Mac)
- Verifica la conexión a internet
- Consulta la Guía de Solución de Problemas
Problemas con la Clave API
- Verifica que la clave API sea correcta
- Comprueba que la clave API tenga los permisos adecuados
- Asegúrate de que la clave esté configurada en la variable de entorno
- Consulta la Guía de Configuración

Seguridad

Las claves API se gestionan únicamente mediante variables de entorno
Nunca subas claves API al control de versiones
El directorio .claude/ está excluido de git
No se registra ni almacena ningún dato sensible
Actualizaciones de seguridad periódicas
Si tu clave API queda expuesta, regenérala inmediatamente en Google Cloud Console

Licencia

MIT