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

Related MCP server: MCP Server for Google Search

📋 Requisitos previos

Antes de comenzar, asegúrese de tener:

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
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
Requisitos de desarrollo local:
- Node.js (v18 o superior)
- npm (viene con Node.js)

🚀 Inicio rápido

Clonar el repositorio:
git clone https://github.com/yourusername/mcp-google-custom-search-server.git cd mcp-google-custom-search-server
Instalar dependencias:
npm install
Crea un archivo .env:
GOOGLE_API_KEY=your-api-key GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id
Construir el servidor:
npm run build
Iniciar el servidor:
npm start

🔧 Configuración

Variables de entorno

Variable	Descripción	Requerido
CLAVE DE API DE GOOGLE	Su clave API de búsqueda personalizada de Google	Sí
ID DEL MOTOR DE BÚSQUEDA DE GOOGLE	Su ID de motor de búsqueda personalizado	Sí

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 ):

{ "mcpServers": { "google-search": { "command": "node", "args": [ "/absolute/path/to/mcp-google-custom-search-server/build/index.js" ], "env": { "GOOGLE_API_KEY": "your-api-key", "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id" } } } }

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:

Result 1: Title: Example Search Result URL: https://example.com Description: This is an example search result description --- Result 2: ...

🛠️ Desarrollo

Estructura del proyecto

mcp-google-custom-search-server/ ├── src/ │ └── index.ts # Main server implementation ├── build/ # Compiled JavaScript output ├── .env # Environment variables ├── package.json # Project dependencies and scripts ├── tsconfig.json # TypeScript configuration └── README.md # Project documentation

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

Usando MCP Inspector:
npx @modelcontextprotocol/inspector node build/index.js
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