Skip to main content
Glama

gemini-mcp

npm MCP Registry Node.js License: MIT

Servidor MCP ligero que expone Google Gemini como herramientas para Claude Code (o cualquier cliente MCP).

Usa Gemini para segundas opiniones, análisis de contexto amplio, revisión de código o cualquier cosa donde una perspectiva de modelo diferente ayude.

Herramientas

Tool

Descripción

gemini_ask

Pregunta a Gemini una cuestión o dale una tarea

gemini_analyze

Envía código/texto para análisis con una instrucción específica

gemini_chat

Conversación de múltiples turnos con historial completo

gemini_models

Lista los modelos de Gemini disponibles

Related MCP server: Gemini Bridge

Inicio Rápido

1. Obtén una clave de API

Ve a Google AI Studio y crea una clave de API gratuita.

2. Instalación

Opción A — Clonar (recomendado para Claude Code)

git clone https://github.com/PavelGuzenfeld/gemini-mcp.git ~/.claude/mcp-servers/gemini
cd ~/.claude/mcp-servers/gemini
npm install

Opción B — npx (sin instalación)

npx claude-gemini-mcp

3. Regístrate con Claude Code

Añade a ~/.claude/settings.json:

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/home/you/.claude/mcp-servers/gemini/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

O con npx:

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "claude-gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

Ejemplos de Uso

Haz una pregunta

> Use gemini_ask to explain the difference between std::expected and std::optional

Gemini says: std::optional<T> represents a value that may or may not be present...
std::expected<T, E> additionally carries an error value when the expected value is absent...

Analiza código

> Use gemini_analyze to review this function for performance issues:
  instruction: "Find performance bottlenecks"
  content: <your code here>

Gemini says: Line 12 allocates inside the loop — move the vector outside...

Conversación de múltiples turnos

> Use gemini_chat with messages:
  [{"role": "user", "content": "Design a REST API for a task manager"},
   {"role": "model", "content": "Here's a RESTful design..."},
   {"role": "user", "content": "Now add authentication"}]

Gemini says: Building on the previous design, add JWT-based auth...

Sobrescribir modelo por llamada

> Use gemini_ask with model: "gemini-2.5-flash" to quickly summarize this error log

Variables de Entorno

Variable

Default

Descripción

GEMINI_API_KEY

(requerido)

Clave de API de Google AI Studio

GEMINI_MODEL

gemini-2.5-pro

Modelo predeterminado para todas las herramientas

Modelos

Model

Mejor para

gemini-2.5-pro

Mejor calidad, contexto amplio (1M tokens)

gemini-2.5-flash

Rápido, bueno para la mayoría de tareas

gemini-2.0-flash

Más rápido, tareas simples

Cada herramienta acepta un parámetro opcional model para sobrescribir el predeterminado por llamada.

Características

  • Reintento con retroceso exponencial en límites de velocidad (429) y errores de servidor (5xx)

  • Informe de errores elegante de vuelta al cliente MCP (sin bloqueos)

  • Sobrescritura de modelo por llamada

  • Cero configuración más allá de la clave de API

Solución de Problemas

Problema

Solución

GEMINI_API_KEY is not set

Añade la clave a tu bloque env en settings.json

429 Too Many Requests

El reintento integrado maneja esto — espera unos segundos

Model not found

Ejecuta gemini_models para listar nombres de modelo válidos

Las herramientas no aparecen en Claude Code

Comprueba la sintaxis de ~/.claude/settings.json, reinicia Claude Code

ECONNREFUSED

Comprueba red/firewall — el servidor llama a generativelanguage.googleapis.com

Desarrollo

git clone https://github.com/PavelGuzenfeld/gemini-mcp.git
cd gemini-mcp
npm install
npm test          # Run smoke tests
node index.js     # Start the MCP server locally

Licencia

MIT

Related MCP Connectors

Related MCP Servers