mcp-google-server Un servidor MCP para la búsqueda personalizada de Google y la lectura de páginas web

Un servidor de protocolo de contexto de modelo que proporciona capacidades de búsqueda web mediante la API de búsqueda personalizada de Google y la funcionalidad de extracción de contenido de páginas web.

Configuración

Obtener la clave API de Google y el ID del motor de búsqueda

Crear un proyecto de Google Cloud:
- Ir a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona uno existente
- Habilitar la facturación para su proyecto
Habilitar API de búsqueda personalizada:
- Ir a la biblioteca API
- Buscar "API de búsqueda personalizada"
- Haga clic en "Habilitar"
Obtener clave API:
- Ir a Credenciales
- Haga clic en "Crear credenciales" > "Clave API".
- Copia tu clave API
- (Opcional) Restrinja la clave API solo a la API de búsqueda personalizada
Crear un motor de búsqueda personalizado:
- Ir al motor de búsqueda programable
- Ingrese los sitios que desea buscar (use www.google.com para búsquedas web generales)
- Haga clic en "Crear"
- En la página siguiente, haga clic en "Personalizar".
- En la configuración, activa "Buscar en toda la web".
- Copia tu ID de motor de búsqueda (cx)

Related MCP server: MCP Server for Google Search

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Características

Herramienta de búsqueda

Realice búsquedas web utilizando la API de búsqueda personalizada de Google:

Busque en toda la web o en sitios específicos
Número de control de resultados (1-10)
Obtenga resultados estructurados con título, enlace y fragmento

Herramienta de lectura de páginas web

Extraer contenido de cualquier página web:

Obtener y analizar el contenido de la página web
Extraer el título de la página y el texto principal
Limpiar el contenido eliminando scripts y estilos
Devuelve datos estructurados con título, texto y URL

Instalación

Instalación mediante herrería

Para instalar Google Custom Search Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

Para usar con Claude Desktop, agregue la configuración del servidor con sus credenciales de API de Google:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "google-search": { "command": "npx", "args": [ "-y", "@adenot/mcp-google-search" ], "env": { "GOOGLE_API_KEY": "your-api-key-here", "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here" } } } }

Uso

Herramienta de búsqueda

{ "name": "search", "arguments": { "query": "your search query", "num": 5 // optional, default is 5, max is 10 } }

Herramienta de lectura de páginas web

{ "name": "read_webpage", "arguments": { "url": "https://example.com" } }

Ejemplo de respuesta del lector de la página web:

{ "title": "Example Domain", "text": "Extracted and cleaned webpage content...", "url": "https://example.com" }

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.