¡¡¡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
Prerrequisitos
- Node.js (v16 o superior)
- Cuenta de Google Cloud Platform
- ID de motor de búsqueda personalizado
- Clave API de Google
Instalación
- Clonar el repositorio
- Instalar las dependencias de Node.js:
- Construya el código TypeScript:
Configuración
- 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 GoogleGOOGLE_SEARCH_ENGINE_ID : Su ID de motor de búsqueda personalizado
- 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:
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
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)
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
- Vaya a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona uno existente
- Habilitar la API de búsqueda personalizada
- Crear credenciales de API (clave API)
- Vaya a la página del motor de búsqueda personalizado
- Cree un nuevo motor de búsqueda y obtenga su ID de motor de búsqueda
- 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:
- GoogleSearchService : gestiona las interacciones de la API de Google para la funcionalidad de búsqueda.
- 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:
- Construya el código TypeScript:
- 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));"
- 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:
- Configurar sus credenciales de API de Google como variables de entorno
- Agregue la configuración del servidor a su archivo de configuración MCP
- 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)