Skip to main content
Glama
deenesjakoruzh
mixelpixx

Google Search MCP Server

by mixelpixx
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote

¡¡¡La versión 2.0 ya está aquí!!!

NOTICIAS: ¡mi NUEVO 'KiCAD MCP Server' ya está aquí, junto con este 'Google Search MCP Server' son un dúo poderoso!

https://github.com/mixelpixx/KiCAD-MCP-Server

Servidor MCP de Búsqueda de Google

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona funciones de búsqueda de Google y herramientas de análisis de contenido web. Este servidor permite que los modelos de IA realicen búsquedas en Google y analicen el contenido web mediante programación.

Características

  • Integración de búsqueda personalizada de Google

  • Funciones de búsqueda avanzada (filtros, clasificación, paginación, categorización)

  • Análisis de contenido de páginas web en múltiples formatos (markdown, HTML, texto plano)

  • Análisis de páginas web por lotes

  • Categorización y clasificación de resultados

  • Resumen de contenido

  • Respuestas optimizadas y legibles para humanos

  • Interfaz compatible con MCP

Related MCP server: searchAPI-mcp

Prerrequisitos

  • Node.js (v16 o superior)

  • Cuenta de Google Cloud Platform

  • ID de motor de búsqueda personalizado

  • Clave API de Google

Instalación

  1. Clonar el repositorio

  2. Instalar las dependencias de Node.js:

npm install

  1. Construya el código TypeScript:

npm run build

Configuración

  1. Configure variables de entorno para sus credenciales de API de Google:

Puede configurarlos como variables de entorno del sistema o configurarlos en el archivo de configuración de MCP.

Variables de entorno requeridas:

  • GOOGLE_API_KEY : Su clave API de Google

  • GOOGLE_SEARCH_ENGINE_ID : Su ID de motor de búsqueda personalizado

  1. Agregue la configuración del servidor a su archivo de configuración de MCP (normalmente ubicado en %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):

{ "mcpServers": { "google-search": { "autoApprove": [ "google_search", "extract_webpage_content", "extract_multiple_webpages" ], "disabled": false, "timeout": 60, "command": "node", "args": [ "/path/to/google-search-mcp-server/dist/google-search.js" ], "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id" }, "transportType": "stdio" } } }

Correr

Inicie el servidor MCP:

npm run start

Herramientas disponibles

1. búsqueda de Google

Busca en Google y encuentra resultados relevantes de la web. Esta herramienta encuentra páginas web, artículos e información sobre temas específicos mediante el motor de búsqueda de Google.

{ "name": "google_search", "arguments": { "query": "your search query", "num_results": 5, // optional, default: 5 "site": "example.com", // optional, limit results to specific website "language": "en", // optional, filter by language (ISO 639-1 code) "dateRestrict": "m6", // optional, filter by date (e.g., "m6" for last 6 months) "exactTerms": "exact phrase", // optional, search for exact phrase "resultType": "news", // optional, specify type (news, images, videos) "page": 2, // optional, page number for pagination (starts at 1) "resultsPerPage": 10, // optional, results per page (max: 10) "sort": "date" // optional, sort by "date" or "relevance" (default) } }

La respuesta incluye:

  • Resultados de búsqueda con título, enlace y fragmento en formato legible

  • Información de paginación (página actual, resultados totales, etc.)

  • Categorías de resultados (detectadas automáticamente)

  • Sugerencias de navegación para la paginación

2. extraer_contenido_de_la_página_web

Extrae y analiza el contenido de una página web, convirtiéndolo en texto legible. Esta herramienta recupera el contenido principal y elimina anuncios, elementos de navegación y demás elementos innecesarios.

{ "name": "extract_webpage_content", "arguments": { "url": "https://example.com", "format": "markdown" // optional, format options: "markdown" (default), "html", or "text" } }

La respuesta incluye:

  • Título y descripción de la página web

  • Estadísticas de contenido (número de palabras, número de caracteres)

  • Resumen del contenido

  • Vista previa del contenido (primeros 500 caracteres)

3. extraer_múltiples_páginas_web

Extraiga y analice contenido de varias páginas web con una sola solicitud. Ideal para comparar información de diferentes fuentes o recopilar información completa sobre un tema.

{ "name": "extract_multiple_webpages", "arguments": { "urls": [ "https://example1.com", "https://example2.com" ], "format": "html" // optional, format options: "markdown" (default), "html", or "text" } }

La respuesta incluye:

  • Título y descripción de cada página web

  • Estadísticas de contenido de cada página web

  • Resumen del contenido de cada página web

  • Vista previa del contenido de cada página web (primeros 150 caracteres)

Obtener credenciales de la API de Google

  1. Vaya a la consola de Google Cloud

  2. Crea un nuevo proyecto o selecciona uno existente

  3. Habilitar la API de búsqueda personalizada

  4. Crear credenciales de API (clave API)

  5. Vaya a la página del motor de búsqueda personalizado

  6. Cree un nuevo motor de búsqueda y obtenga su ID de motor de búsqueda

  7. Agregue estas credenciales a su archivo de configuración de MCP o configúrelas como variables de entorno

Manejo de errores

El servidor proporciona mensajes de error detallados para:

  • Credenciales de API faltantes o no válidas

  • Solicitudes de búsqueda fallidas

  • URL de páginas web no válidas

  • Problemas de conectividad de red

Arquitectura

El servidor está desarrollado con TypeScript y utiliza el SDK de MCP para proporcionar una interfaz estandarizada que permite a los modelos de IA interactuar con la Búsqueda de Google y las herramientas de análisis de contenido web. Consta de dos servicios principales:

  1. GoogleSearchService : gestiona las interacciones de la API de Google para la funcionalidad de búsqueda.

  2. ContentExtractor : gestiona el análisis y la extracción de contenido de páginas web

El servidor utiliza mecanismos de almacenamiento en caché para mejorar el rendimiento y reducir las llamadas API.

Distribuyendo la versión compilada

Si prefiere distribuir solo la versión compilada de esta herramienta en lugar del código fuente, puede seguir estos pasos:

  1. Construya el código TypeScript:

npm run build

  1. Cree un paquete de distribución con solo los archivos necesarios:

# Create a distribution directory mkdir -p dist-package # Copy the compiled JavaScript files cp -r dist dist-package/ # Copy package files (without dev dependencies) cp package.json dist-package/ cp README.md dist-package/ # Create a simplified package.json for distribution node -e "const pkg = require('./package.json'); delete pkg.devDependencies; delete pkg.scripts.build; delete pkg.scripts.dev; pkg.scripts.start = 'node dist/google-search.js'; require('fs').writeFileSync('dist-package/package.json', JSON.stringify(pkg, null, 2));"

  1. Los usuarios pueden luego instalar y ejecutar la versión compilada:

# Install production dependencies only npm install --production # Start the server npm start

Este enfoque permite distribuir los archivos JavaScript compilados sin exponer el código fuente de TypeScript. Los usuarios aún deberán:

  1. Configurar sus credenciales de API de Google como variables de entorno

  2. Agregue la configuración del servidor a su archivo de configuración MCP

  3. Instalar las dependencias de producción

Tenga en cuenta que el paquete.json en la distribución solo incluirá dependencias de producción y un conjunto simplificado de scripts.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

One-click Deploy
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mixelpixx/Google-Search-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server