Google Web Search (Gemini)

Proporciona funcionalidad de búsqueda web de Google utilizando la API de Gemini. Requiere una clave de API de Google o credenciales OAuth.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Búsqueda Web de Google Gemini

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona funcionalidad de Búsqueda Web de Google utilizando la API de Gemini. Este servidor está extraído de la herramienta de búsqueda web del CLI oficial de Gemini.

Características

  • Búsqueda Web de Google a través de la API de Gemini
  • Soporte de citas con enlaces de origen
  • Metadatos de fundamentación para una recuperación precisa de información
  • Totalmente compatible con Claude Desktop y otros clientes MCP

Requisitos previos

  • Node.js 18+
  • Clave de API de Google (acceso a la API de Gemini)

Instalación

Vía npm (cuando se publique)

npm install -g gemini-google-web-search-mcp

Desde el código fuente

git clone https://github.com/yourusername/gemini-google-web-search-mcp.git
cd gemini-google-web-search-mcp
npm install
npm run build

Configuración

1. Obtener una clave de API de Google

Visita Google AI Studio para crear tu clave de API.

2. Configurar Claude Desktop

Agrega lo siguiente a tu archivo de configuración de 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

Opción 1: Autenticación con clave de API

{
  "mcpServers": {
    "google-web-search": {
      "command": "node",
      "args": ["/path/to/gemini-google-web-search-mcp/dist/index.js"],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opción 2: Autenticación OAuth (sin necesidad de clave de API)

{
  "mcpServers": {
    "google-web-search": {
      "command": "node",
      "args": ["/path/to/gemini-google-web-search-mcp/dist/index-codeassist.js"],
      "env": {
        "USE_OAUTH": "true"
      }
    }
  }
}

Uso

Una vez configurado, la herramienta google_web_search estará disponible en Claude Desktop. Puedes usarla pidiendo a Claude que busque información:

  • "Busca las últimas noticias sobre el protocolo MCP"
  • "Encuentra información sobre las características de TypeScript 5.0"
  • "Consulta los desarrollos recientes en seguridad de IA"

Variables de entorno

  • GOOGLE_API_KEY o GEMINI_API_KEY: Tu clave de API de Google (requerida)
  • GEMINI_MODEL: Modelo de Gemini a utilizar (predeterminado: gemini-2.0-flash-exp)
  • USE_OAUTH: Establécelo en true para usar autenticación OAuth (experimental, no totalmente compatible)
  • GOOGLE_APPLICATION_CREDENTIALS: Ruta a las credenciales de la cuenta de servicio (opcional)

Métodos de autenticación

1. Autenticación con clave de API (recomendada)

La forma más fácil de autenticarse es usando una clave de API:

export GOOGLE_API_KEY=your-api-key-here

2. Autenticación OAuth con API de Code Assist (requiere configuración)

La autenticación OAuth utiliza la API de Code Assist de Google, que proporciona funcionalidad de búsqueda web con inicio de sesión de Google.

Pasos de configuración:

  1. Establecer credenciales OAuth (si se usa una aplicación OAuth personalizada):

    export OAUTH_CLIENT_ID=your-oauth-client-id
export OAUTH_CLIENT_SECRET=your-oauth-client-secret

  2. Ejecutar el script de configuración automatizado:

    ./setup-gcp.sh

  3. O configurar manualmente:

    # Set your Google Cloud project ID
export GOOGLE_CLOUD_PROJECT=your-project-id

# Enable required APIs
gcloud services enable cloudaicompanion.googleapis.com

# Set up authentication
gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/generative-language.retriever

  4. Usar autenticación OAuth:

    export USE_OAUTH=true
npm run dev:cli -- "your search query"

Requisitos:

  • Proyecto de Google Cloud con facturación habilitada
  • API de Cloud AI Companion habilitada
  • Suscripción a Gemini Code Assist (nivel gratuito disponible)

Nota: Esto utiliza el mismo flujo de autenticación que el CLI de Gemini y accede a la API de Code Assist de Google para la funcionalidad de búsqueda web.

Desarrollo

Compilación

npm run build

Ejecución en desarrollo

npm run dev

Pruebas

# Set your API key
export GOOGLE_API_KEY=your-api-key-here

# Run the test
npm test

Implementación del protocolo MCP

Este servidor implementa el Protocolo de Contexto de Modelo con:

  • Herramienta: google_web_search
    • Entrada: query (cadena) - La consulta de búsqueda
    • Salida: Resultados de búsqueda con citas y enlaces de origen

Licencia

Apache 2.0 - Este proyecto se deriva del CLI de Gemini de Google, que está licenciado bajo Apache 2.0.

Créditos

Este servidor MCP se basa en la funcionalidad de búsqueda web del CLI oficial de Gemini de Google.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción.

Solución de problemas

Problemas con la clave de API

  • Asegúrate de que tu clave de API sea válida y tenga acceso a la API de Gemini
  • Verifica que la variable de entorno esté configurada correctamente

Problemas de conexión

  • Verifica que el servidor MCP esté configurado correctamente en Claude Desktop
  • Revisa los registros del servidor para ver cualquier mensaje de error

La búsqueda no funciona

  • Asegúrate de tener conectividad a internet
  • Comprueba si la API de Gemini es accesible desde tu ubicación
  • Verifica que tu clave de API no haya excedido los límites de velocidad