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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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

MCP Google Server
adenot
A
security
A
license
A
quality
Provides web search capabilities using Google Custom Search API, enabling users to perform searches through a Model Context Protocol server.
Last updated -
2
209
17
JavaScript
MIT License
MCP Salesforce Connector
smn2gnt
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to interact with Salesforce data through SOQL queries, SOSL searches, and various API operations including record management.
Last updated -
10
77
Python
MIT License
Valyu MCP Server
valyu-network
A
security
A
license
A
quality
A Model Context Protocol server that provides LLMs with access to Valyu's knowledge retrieval and feedback APIs for searching proprietary/web sources and submitting transaction feedback.
Last updated -
2
TypeScript
MIT License
Google Search MCP Server
renoscriptdev
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude to perform Google Custom Search operations by connecting to Google's search API.
Last updated -
Python

View all related MCP servers

MCP Google Custom Search Server