¡Diseñado para usar con Cline + VS Code!

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

Búsqueda avanzada de Google con opciones de filtrado (fecha, idioma, país, búsqueda segura)
Extracción y análisis detallado del contenido de páginas web
Análisis de páginas web por lotes para comparar múltiples fuentes
Compatibilidad de variables de entorno con credenciales de API
Manejo integral de errores y retroalimentación del usuario
Interfaz compatible con MCP para una integración perfecta con asistentes de IA

Prerrequisitos

Node.js (v16 o superior)
Python (v3.8 o superior)
Cuenta de Google Cloud Platform
ID de motor de búsqueda personalizado
Clave API de Google

Instalación

Clonar el repositorio:
git clone https://github.com/your-username/google-search-mcp.git cd google-search-mcp
Instalar las dependencias de Node.js:
npm install
Instalar dependencias de Python:
pip install flask google-api-python-client flask-cors beautifulsoup4 trafilatura markdownify
Construya el código TypeScript:
npm run build
Cree un script auxiliar para iniciar los servidores Python (ejemplo de Windows):
# Create start-python-servers.cmd @echo off echo Starting Python servers for Google Search MCP... REM Start Python search server start "Google Search API" cmd /k "python google_search.py" REM Start Python link viewer start "Link Viewer" cmd /k "python link_view.py" echo Python servers started. You can close this window.

Configuración

Credenciales de API

Puede proporcionar las credenciales de la API de Google de dos maneras:

Variables de entorno (recomendadas):
- Establezca GOOGLE_API_KEY y GOOGLE_SEARCH_ENGINE_ID en su entorno
- El servidor utilizará automáticamente estos valores.
Archivo de configuración :
- Cree un archivo api-keys.json en el directorio raíz: GXP6

Configuración de ajustes de MCP

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

Para Cline (extensión de VS Code)

Ubicación del archivo: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "google-search": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\google-search-mcp\\dist\\google-search.js"],
      "cwd": "C:\\path\\to\\google-search-mcp",
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Para la aplicación de escritorio de Claude

Ubicación del archivo: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\google-search-mcp\\dist\\google-search.js"],
      "cwd": "C:\\path\\to\\google-search-mcp",
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ejecución del servidor

Método 1: Iniciar servidores Python por separado (recomendado)

Primero, inicie los servidores Python usando el script auxiliar:
start-python-servers.cmd
Configure los ajustes de MCP para ejecutar solo el servidor Node.js:
{ "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\path\\to\\google-search-mcp\\dist\\google-search.js"] }

Método 2: Script todo en uno

Inicie los servidores TypeScript y Python con un solo comando:

npm run start:all

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, max: 10
    "date_restrict": "w1", // optional, restrict to past day (d1), week (w1), month (m1), year (y1)
    "language": "en", // optional, ISO 639-1 language code (en, es, fr, de, ja, etc.)
    "country": "us", // optional, ISO 3166-1 alpha-2 country code (us, uk, ca, au, etc.)
    "safe_search": "medium" // optional, safe search level: "off", "medium", "high"
  }
}

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"
  }
}

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"
    ]
  }
}

Ejemplo de uso

A continuación se muestran algunos ejemplos de cómo utilizar las herramientas MCP de Búsqueda de Google:

Búsqueda básica

Search for information about artificial intelligence

Búsqueda avanzada con filtros

Search for recent news about climate change from the past week in Spanish

Extracción de contenido

Extract the content from https://example.com/article

Comparación de contenido múltiple

Compare information from these websites:
- https://site1.com/topic
- https://site2.com/topic
- https://site3.com/topic

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 api-keys.json

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 consta de dos componentes principales:

Servidor MCP de TypeScript: gestiona la comunicación del protocolo MCP y proporciona la interfaz de la herramienta
Servidor Python Flask: administra las interacciones de la API de Google y el análisis del contenido de las páginas web

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Google Search MCP Server

Integrations