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

1. 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

2. Habilitar API de búsqueda personalizada:

   • Ir a la biblioteca API

   • Buscar "API de búsqueda personalizada"

   • Haga clic en "Habilitar"

3. 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

4. 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.