gemini-mcp-tool MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Accede al contexto de ~1M-token de Gemini desde Claude
La sintaxis @ referencia archivos y directorios
sandbox-test ejecuta código de forma segura en el sandbox de Gemini
Comandos slash en Claude Code (/analyze, /sandbox, /help, /ping)
Instalación simple con claude mcp add

Demo en vivo

Cómo se ve en la práctica

gemini-mcp-tool.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "gemini-mcp-tool",
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "gemini-mcp-tool": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "gemini-mcp-tool"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add gemini-mcp-tool -- npx -y gemini-mcp-tool

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: gemini-mcp-tool

Cómo analizar un archivo masivo que no cabe en el contexto de Claude

👤 Desarrolladores que trabajan con registros grandes, bases de código o documentos ⏱ ~15 min intermediate

Cuándo usarlo: Claude no puede contener el archivo, pero Gemini sí.

Requisitos previos

Gemini CLI + clave API de Google — npm i -g @google/gemini-cli; luego gemini config set con tu clave de aistudio.google.com
Instalar MCP — claude mcp add gemini-cli -- npx -y gemini-mcp-tool

Flujo

Descargar análisis

ask-gemini: @/var/log/app-2026-04.log — encuentra todos los errores 5xx agrupados alrededor de despliegues en las últimas 72h, produce una tabla.✓ Copiado

→ Gemini analiza, devuelve un resumen compacto
Profundizar con Claude

Con base en el resumen de Gemini, enfócate en el cluster alrededor del 2026-04-12 14:30 UTC y propón una causa raíz.✓ Copiado

→ Claude razona sobre el resumen

Resultado: Resultado que ninguno de los dos modelos podría producir solo en un intento.

Errores comunes

Enviar registros sensibles a Gemini — Elimina PII antes de invocar ask-gemini o usa un modelo autohospedado en su lugar
Costo de tokens en Gemini Pro para entradas masivas — Usa Gemini Flash para reducir costos; Pro solo cuando la precisión importa

Combinar con: filesystem

Cómo revisar una base de código pequeña completa de una sola vez

👤 Ingenieros auditando servicios pequeños ⏱ ~20 min intermediate

Cuándo usarlo: Quieres una revisión holística que considere todos los archivos a la vez.

Flujo

Pasar el repositorio completo

ask-gemini: @./src/ — revisa problemas estructurales, patrones repetidos que deberían abstraerse y código muerto.✓ Copiado

→ Observaciones en todo el repositorio
Clasificar sugerencias

De esos, ¿cuál 3 tienen mayor impacto? Nombra los archivos.✓ Copiado

→ Lista priorizada

Resultado: La primera pasada de un revisor producida en un prompt.

Errores comunes

Gemini pierde detalle en repositorios masivos — Si tu src/ excede 500k tokens, reduce a subdirectorios

Combinar con: github

Cómo ejecutar código no seguro en el sandbox de Gemini

👤 Desarrolladores probando fragmentos de código no confiable ⏱ ~5 min beginner

Cuándo usarlo: Quieres intentar ejecutar algo sin permitir que toque tu máquina.

Flujo

Enviar al sandbox

sandbox-test: ejecuta este script de Python [pega] — reporta stdout/stderr y código de salida.✓ Copiado

→ Salida sin efectos secundarios en tu máquina

Resultado: Resultado de ejecución segura.

Errores comunes

El sandbox no tiene internet por defecto para la mayoría de fragmentos — Revisa la documentación del sandbox de Gemini CLI para opciones de conectividad

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

gemini-mcp-tool + filesystem

Selecciona archivos localmente, pasa referencias @ a Gemini

Lista todos los archivos *.log modificados hoy vía filesystem, luego ask-gemini @ cada uno para encontrar anomalías.✓ Copiado

gemini-mcp-tool + github

Revisa un PR entregando el diff completo al contexto amplio de Gemini

Obtén el diff del PR #4421 vía github MCP, luego ask-gemini para criticar todo el diff como un cambio coherente.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
ask-gemini	prompt: str (puede incluir referencias @path), model?: 'flash'\|'pro'	Análisis de contexto amplio	Llamada a la API de Gemini — Flash ~$0.075/1M de entrada, Pro más alto
sandbox-test	code: str, language?	Ejecutar código no confiable	Facturación del sandbox de Gemini
Ping		Verificación de cordura de la conexión	gratuito

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Gemini AI Studio tiene un nivel gratuito; el nivel de pago es pago por token
Tokens por llamada: Grande — este es el punto principal. Planifica 100k-500k tokens por llamada.
Monetario: Gemini 2.5 Flash ~$0.075 por 1M de entrada; Pro es ~20x más
Consejo: Por defecto usa Flash. Escala a Pro solo cuando Flash claramente está mal.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Clave API de Gemini

Almacenamiento de credenciales: Gemini CLI almacena la clave en ~/.config/gemini/

Salida de datos: El contenido del archivo va a Google Gemini; sujeto a la política de datos de la API Gemini de Google

No conceder nunca: No pases secretos en archivos referenciados con @ — van directo a Google

Los archivos enviados vía @ se cargan en Gemini — trátalos como lo harías con cualquier carga en la nube.

Resolución de problemas

Errores comunes y soluciones

gemini-cli no encontrado

Instala globalmente: npm i -g @google/gemini-cli; asegúrate de que npm global bin esté en PATH.

Verificar: which gemini

401 de Gemini

Ejecuta gemini config para configurar tu clave API desde aistudio.google.com.

Verificar: gemini 'hello'

Límite de token excedido

Incluso Gemini tiene límites; reduce referencias @ o usa búsqueda para reducir archivos primero.

Tiempo de espera del sandbox agotado

El código de larga duración necesita un tiempo de espera más alto; o ejecútalo localmente en un contenedor en su lugar.

Alternativas

gemini-mcp-tool vs otros

Alternativa	Cuándo usarla	Contrapartida
deep-research MCP	Quieres investigación autónoma, no acceso crudo a Gemini	Forma diferente; incluye búsqueda web
openrouter MCP	Quieres acceso multimodelo a través de una sola clave	Sin sintaxis @-file; menos conveniente para contextos grandes

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills