Gemini

Proporciona acceso a las capacidades de IA de Google Gemini como herramientas.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Gemini

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de IA de Google Gemini como herramientas. Construido con Deno y TypeScript.

Características

  • ask_gemini: Asistente de IA unificado impulsado por Gemini 3 Pro con búsqueda integrada de Google y capacidades de análisis de URL

Requisitos previos

Instalación

Opción 1: Usar el paquete JSR (Recomendado)

La forma más sencilla es usar el paquete JSR publicado directamente en tu configuración de Claude Desktop:

# No installation needed! Use jsr:@cong/gemini-mcp directly in your Claude config

Opción 2: Desde el código fuente

  1. Clona este repositorio:
git clone <repository-url>
cd gemini-mcp
  1. Configura tus variables de entorno:
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview

Uso

Iniciar el servidor

# Set your environment variables first
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview

# Development mode (with watch)
deno task dev

# Production mode
deno task start

Pruebas con MCP Inspector

Para probar el servidor con MCP Inspector, asegúrate de que tus variables de entorno estén configuradas:

# Set environment variables in your shell
export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview

# Install MCP Inspector if you haven't already
npm install -g @modelcontextprotocol/inspector

# Run the inspector
npx @modelcontextprotocol/inspector src/server.ts

Importante: Las variables de entorno deben estar configuradas en la misma terminal donde ejecutes MCP Inspector.

Ejecutar pruebas

# Run all tests
deno task test

# Run tests with watch mode
deno task test:watch

Calidad del código

# Format code
deno fmt

# Lint code
deno lint

Herramienta MCP

ask_gemini

El asistente de IA unificado impulsado por Gemini 3 Pro con búsqueda integrada de Google y capacidades de análisis de URL.

Parámetros:

  • prompt (obligatorio): Tu pregunta o solicitud. Incluye URLs directamente en el texto para su análisis.

Ejemplo:

{
  "name": "ask_gemini",
  "arguments": {
    "prompt": "What are the latest developments in quantum computing? Please analyze this paper: https://arxiv.org/abs/2301.01234"
  }
}

Capacidades:

  • 🔍 Busca automáticamente en la web información actual
  • 📄 Analiza URLs mencionadas en el texto de tu prompt
  • 🧠 Usa Gemini 3 Pro con capacidades de razonamiento, herramientas urlContext y googleSearch
  • 📚 Proporciona respuestas completas y bien fundamentadas con razonamiento mejorado

Dependencias

Desarrollo

Este proyecto usa Deno con TypeScript. Comandos clave de desarrollo:

  • deno task dev - Iniciar servidor de desarrollo con modo de observación
  • deno task test - Ejecutar suite de pruebas
  • deno cache src/server.ts - Almacenar dependencias en caché
  • deno fmt - Formatear código
  • deno lint - Verificar lint del código

Solución de problemas

Problemas con variables de entorno

Si recibes errores de variables de entorno:

  1. Verifica que tus variables de entorno estén configuradas:

    echo $GEMINI_API_KEY
echo $GEMINI_MODEL

  2. Para pruebas con MCP Inspector, asegúrate de que ambas variables estén configuradas en la misma terminal:

    export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-3-pro-preview
npx @modelcontextprotocol/inspector src/server.ts

  3. Revisa los registros del servidor: Cuando el servidor se inicia, mostrará (API Key: configured) para confirmar que tu clave está cargada.

Soporte

Configuración de Claude Desktop

Para usar este servidor MCP con Claude Desktop, agrégalo a tu configuración de Claude:

macOS/Linux/Windows

Edita tu archivo de configuración de Claude:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gemini": {
      "command": "deno",
      "args": [
        "run",
        "--allow-net",
        "--allow-env",
        "jsr:@cong/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-3-pro-preview"
      }
    }
  }
}

Desarrollo local

Si estás ejecutando desde el código fuente:

{
  "mcpServers": {
    "gemini": {
      "command": "deno",
      "args": [
        "run",
        "--allow-net",
        "--allow-env",
        "src/server.ts"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-3-pro-preview"
      }
    }
  }
}

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de características
  3. Realiza tus cambios
  4. Ejecuta las pruebas: deno task test
  5. Formatea el código: deno fmt
  6. Envía una solicitud de pull

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.