Gemini MCP Tool

Gemini MCP Tool

📚 Ver Documentación Completa - ¡Búscame!, Ejemplos, Preguntas Frecuentes, Solución de Problemas, Mejores Prácticas

Este es un servidor simple del Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA interactuar con el Gemini CLI. Permite que la IA aproveche el poder de la enorme ventana de tokens de Gemini para análisis extensos, especialmente con archivos grandes y bases de código usando la sintaxis @ para dirección.

• Haz preguntas naturales a Gemini a través de Claude o genera nuevas ideas en una fiesta de 3.

TLDR: + ()

Objetivo: Usar las potentes capacidades de análisis de Gemini directamente en Claude Code para ahorrar tokens y analizar archivos grandes.

Requisitos Previos

curl -fsSL https://antigravity.google/cli/install.sh | bash   # macOS / Linux

GEMINI_MCP_BACKEND=gemini

Antes de usar esta herramienta, asegúrate de tener:

1. Node.js (v16.0.0 o superior)
2. Google Gemini CLI instalado y configurado

Configuración en una Línea

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

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

Verificar Instalación

Escribe /mcp dentro de Claude Code para verificar que el MCP de gemini-cli esté activo.

Alternativa: Importar desde Claude Desktop

Si ya lo tienes configurado en Claude Desktop:

1. Agrega a tu configuración de Claude Desktop:

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

2. Importa a Claude Code:

claude mcp add-from-claude-desktop

Configuración

Registra el servidor MCP con tu cliente MCP:

Para uso con NPX (Recomendado)

Agrega esta configuración a tu archivo de configuración de Claude Desktop:

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

Para Instalación Global

Si lo instalaste globalmente, usa esta configuración en su lugar:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "gemini-mcp"
    }
  }
}

Ubicaciones de Archivos de Configuración:

• Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json

Después de actualizar la configuración, reinicia tu sesión de terminal.

Flujo de Trabajo de Ejemplo

• Lenguaje natural: "usa gemini para explicar index.html", "entiende el proyecto masivo usando gemini", "pide a gemini que busque las últimas noticias"
• Claude Code: Escribe /gemini-cli y los comandos se completarán en la interfaz de Claude Code.

Ejemplos de Uso

Con Referencias a Archivos (usando la sintaxis @)

• ask gemini to analyze @src/main.js and explain what it does
• use gemini to summarize @. the current directory
• analyze @package.json and tell me about dependencies

Preguntas Generales (sin archivos)

• ask gemini to search for the latest tech news
• use gemini to explain div centering
• ask gemini about best practices for React development related to @file_im_confused_about

Usando el Modo Sandbox de Gemini CLI (-s)

El modo sandbox te permite probar cambios de código de forma segura, ejecutar scripts o realizar operaciones potencialmente riesgosas en un entorno aislado.

• use gemini sandbox to create and run a Python script that processes data
• ask gemini to safely test @script.py and explain what it does
• use gemini sandbox to install numpy and create a data visualization
• test this code safely: Create a script that makes HTTP requests to an API

Herramientas (para la IA)

Estas herramientas están diseñadas para ser usadas por el asistente de IA.

• ask-gemini: Pide a Google Gemini su perspectiva. Se puede usar para preguntas generales o análisis complejos de archivos.
  • prompt (obligatorio): La solicitud de análisis. Usa la sintaxis @ para incluir referencias a archivos o directorios (p. ej., @src/main.js explain this code) o haz preguntas generales (p. ej., Please use a web search to find the latest news stories).
  • model (opcional): El modelo de Gemini a usar. El valor predeterminado es gemini-2.5-pro.
  • sandbox (opcional): Establécelo en true para ejecutar en modo sandbox para una ejecución segura de código.
• sandbox-test: Ejecuta código o comandos de forma segura en el entorno sandbox de Gemini. Siempre se ejecuta en modo sandbox.
  • prompt (obligatorio): Solicitud de prueba de código (p. ej., Create and run a Python script that... o @script.py Run this safely).
  • model (opcional): El modelo de Gemini a usar.
• Ping: Una herramienta de prueba simple que devuelve un mensaje.
• Help: Muestra el texto de ayuda del CLI de Gemini.

Comandos de Barra (para el Usuario)

Puedes usar estos comandos directamente en la interfaz de Claude Code (la compatibilidad con otros clientes no ha sido probada).

• /analyze: Analiza archivos o directorios usando Gemini, o haz preguntas generales.
  • prompt (obligatorio): El mensaje de análisis. Usa la sintaxis @ para incluir archivos (p. ej., /analyze prompt:@src/ summarize this directory) o haz preguntas generales (p. ej., /analyze prompt:Please use a web search to find the latest news stories).
• /sandbox: Prueba código o scripts de forma segura en el entorno sandbox de Gemini.
  • prompt (obligatorio): Solicitud de prueba de código (p. ej., /sandbox prompt:Create and run a Python script that processes CSV data o /sandbox prompt:@script.py Test this script safely).
• /help: Muestra la información de ayuda del CLI de Gemini.
• /ping: Prueba la conexión al servidor.
  • message (opcional): Un mensaje para devolver.

Contribuciones

¡Las contribuciones son bienvenidas! Consulta nuestras Pautas de Contribución para obtener detalles sobre cómo enviar solicitudes de extracción, informar problemas y contribuir al proyecto.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENCIA para más detalles.

Aviso legal: Esta es una herramienta no oficial de terceros y no está afiliada, respaldada ni patrocinada por Google.