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:

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de protocolo de contexto de modelo que permite a los LLM realizar búsquedas web utilizando la API de búsqueda personalizada de Google a través de una interfaz estandarizada.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Serper MCP Server
garylab
-
security
F
license
-
quality
A Model Context Protocol server that enables LLMs to perform Google searches via the Serper API, allowing models to retrieve current information from the web.
Last updated -
8
Python
MCP Server for Google Search
mcp-for-dev
A
security
F
license
A
quality
A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.
Last updated -
2
4
1
JavaScript
Google PSE MCP Server
rendyfebry
-
security
A
license
-
quality
A Model Context Protocol server that enables LLM clients like VSCode, Copilot, and Claude Desktop to search the web using Google Programmable Search Engine API.
Last updated -
39
4
JavaScript
Apache 2.0
Gemini MCP Server
philschmid
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to perform web searches using Google's Gemini API and return synthesized responses with citations.
Last updated -
27
Python
MIT License

View all related MCP servers

MCP Google Custom Search Server