Gemini MCP Server

Gemini MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de búsqueda en internet impulsadas por IA a través de la herramienta gemini-cli.

Descripción general

Este servidor MCP permite a Claude y otros asistentes de IA realizar búsquedas en internet en tiempo real mediante la interfaz con la herramienta de línea de comandos gemini-cli. Proporciona una única herramienta query que puede buscar información actual y ofrecer análisis impulsados por IA.

Características

• Búsqueda en tiempo real: Consulta datos actuales de internet mediante búsqueda impulsada por IA
• Protocolo MCP: Implementa el Model Context Protocol para una integración fluida
• Transmisión HTTP: Utiliza transporte de transmisión HTTP para una comunicación eficiente
• TypeScript: Totalmente tipado con TypeScript para mayor fiabilidad
• Apagado elegante: Maneja señales SIGINT/SIGTERM para salidas limpias

Requisitos previos

• Node.js 18+
• gemini-cli instalado y configurado en tu sistema
• TypeScript (para desarrollo)

Instalación

1. Clona el repositorio:

git clone <repository-url>
cd gemini-mcp

2. Instala las dependencias:

npm install

3. Compila el proyecto:

npm run build

Uso

Modo de desarrollo

npm run dev

Modo de producción

npm start

El servidor se iniciará en el puerto 13001 por defecto, o puedes configurar un puerto personalizado:

PORT=8080 npm start

Configuración

Variables de entorno

• PORT: Puerto del servidor (predeterminado: 13001)

Herramienta MCP

El servidor proporciona una herramienta:

query

• Descripción: Envía una consulta a un agente de IA que puede buscar datos en internet en tiempo real
• Parámetros:
  • text (cadena): La consulta o pregunta de búsqueda para enviar al agente de IA
• Devuelve: Respuesta generada por IA con información actual

Integración

Con Claude Desktop

Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "gemini-search": {
      "command": "node",
      "args": ["path/to/gemini-mcp/dist/index.js"],
      "env": {
        "PORT": "13001"
      }
    }
  }
}

Con otros clientes MCP

Conéctate al punto final de transmisión HTTP:

http://localhost:13001

Desarrollo

Scripts

• npm run build - Compila TypeScript a JavaScript
• npm run start - Ejecuta el servidor compilado
• npm run dev - Ejecuta en modo de desarrollo con ts-node

Estructura del proyecto

src/
├── index.ts          # Main server implementation
├── package.json      # Project configuration
└── dist/            # Compiled JavaScript (after build)

Dependencias

• fastmcp: Marco de trabajo del servidor MCP
• zod: Validación de esquemas
• child_process: Integrado en Node.js para iniciar procesos

Licencia

MIT

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de funcionalidad
3. Realiza tus cambios
4. Prueba exhaustivamente
5. Envía una solicitud de extracción