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

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • MCP server for AI dialogue using various LLM models via AceDataCloud

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/PavelGuzenfeld/gemini-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server