Servidor de búsqueda personalizada de Google MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funciones de búsqueda web a través de la API de Búsqueda Personalizada de Google. Este servidor permite que los Modelos de Aprendizaje de Idiomas (LLM) realicen búsquedas web mediante una interfaz estandarizada.

🌟 Características

• Integración perfecta con la API de búsqueda personalizada de Google

• Implementación de servidor compatible con el Protocolo de Contexto de Modelo (MCP)

• Implementación de tipo seguro usando TypeScript

• Configuración de variables de entorno

• Validación de entrada usando Zod

• Resultados de búsqueda configurables (hasta 10 por consulta)

• Resultados de búsqueda formateados que incluyen títulos, URL y descripciones

• Manejo de errores y validación

• Compatible con Claude Desktop y otros clientes MCP

📋 Requisitos previos

Antes de comenzar, asegúrese de tener:

1. Un proyecto de Google Cloud con API de búsqueda personalizada habilitada

   • Visita la consola de Google Cloud

   • Habilitar la API de búsqueda personalizada

   • Crear credenciales de API

2. Un ID de motor de búsqueda personalizado

   • Visita el motor de búsqueda programable

   • Crear un nuevo motor de búsqueda

   • Obtenga su ID de motor de búsqueda

3. Requisitos de desarrollo local:

   • Node.js (v18 o superior)

   • npm (viene con Node.js)

🚀 Inicio rápido

1. Clonar el repositorio:

   git clone https://github.com/yourusername/mcp-google-custom-search-server.git cd mcp-google-custom-search-server

2. Instalar dependencias:

   npm install

3. Crea un archivo .env:

   GOOGLE_API_KEY=your-api-key GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id

4. Construir el servidor:

   npm run build

5. Iniciar el servidor:

   npm start

🔧 Configuración

Variables de entorno

Integración de escritorio de Claude

Agregue esta configuración a su archivo de configuración de Claude Desktop (normalmente ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json ):

Referencia de API

Herramientas disponibles

buscar

Realiza una búsqueda web mediante la API de búsqueda personalizada de Google.

Parámetros:

• query (cadena, obligatoria): La consulta de búsqueda a ejecutar

• numResults (número, opcional): Número de resultados a devolver

  • Predeterminado: 5

  • Máximo: 10

Ejemplo de respuesta:

🛠️ Desarrollo

Estructura del proyecto

Scripts disponibles

• npm run build : Compilar TypeScript a JavaScript

• npm start : Inicia el servidor MCP

• npm run dev : Modo de observación para el desarrollo

Pruebas

1. Usando MCP Inspector:

   npx @modelcontextprotocol/inspector node build/index.js

2. Pruebas manuales con consultas de ejemplo:

   # After starting the server {"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"search","arguments":{"query":"example search"}}}

📝 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

• Construido con el Protocolo de Contexto de Modelo (MCP)

• Utiliza la API de búsqueda personalizada de Google

• Inspirado por la necesidad de mejores capacidades de búsqueda en las solicitudes de LLM