Serper Search and Scrape

Servidor MCP de Búsqueda y Extracción Serper

Un servidor MCP basado en TypeScript que proporciona capacidades de búsqueda web y extracción de páginas web utilizando la API de Serper. Este servidor se integra con Claude Desktop para habilitar potentes funciones de búsqueda web y extracción de contenido.

Características

Herramientas

• google_search - Realiza búsquedas web a través de la API de Serper

  • Resultados de búsqueda enriquecidos que incluyen resultados orgánicos, grafo de conocimiento, "la gente también pregunta" y búsquedas relacionadas
  • Soporta segmentación por región e idioma
  • Parámetros opcionales para ubicación, paginación, filtros de tiempo y autocorrección
  • Soporta operadores de búsqueda avanzada:
    • site: Limita los resultados a un dominio específico
    • filetype: Limita a tipos de archivo específicos (por ejemplo, 'pdf', 'doc')
    • inurl: Busca páginas con la palabra en la URL
    • intitle: Busca páginas con la palabra en el título
    • related: Encuentra sitios web similares
    • cache: Ver la versión en caché de Google de una URL específica
    • before: Fecha anterior en formato AAAA-MM-DD
    • after: Fecha posterior en formato AAAA-MM-DD
    • exact: Coincidencia de frase exacta
    • exclude: Términos a excluir de los resultados de búsqueda
    • or: Términos alternativos (operador OR)

• scrape - Extrae contenido de páginas web

  • Obtiene texto plano y contenido Markdown opcional
  • Incluye JSON-LD y metadatos de cabecera
  • Preserva la estructura del documento

Requisitos

• Node.js >= 18
• Clave de API de Serper (configurada como variable de entorno SERPER_API_KEY)

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Ejecutar pruebas:

npm test                  # Run all tests
npm run test:watch       # Run tests in watch mode
npm run test:coverage    # Run tests with coverage
npm run test:integration # Run integration tests

Variables de Entorno

Crea un archivo .env en el directorio raíz:

SERPER_API_KEY=your_api_key_here

Depuración

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

npm run inspector

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

Instalación

Instalación mediante Smithery

Para instalar Serper Search and Scrape para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude

Claude Desktop

Añade la configuración del servidor en:

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

{
  "mcpServers": {
    "serper-search": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cline

1. Abre la configuración de la extensión Cline
2. Abre la pestaña "Servidores MCP"
3. Haz clic en "Configurar servidores MCP"
4. Añade la configuración del servidor:

{
  "mcpServers": {
    "github.com/marcopesani/mcp-server-serper": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": ["google_search", "scrape"]
    }
  }
}

Opciones adicionales de configuración de Cline:

• disabled: Configúralo en false para habilitar el servidor
• autoApprove: Lista de herramientas que no requieren aprobación explícita para cada uso

Cursor

1. Abre la configuración de Cursor
2. Abre la configuración de "Funciones"
3. En la sección "Servidores MCP", haz clic en "Añadir nuevo servidor MCP"
4. Elige un nombre y selecciona "command" como "Tipo"
5. En el campo "Comando", introduce lo siguiente:

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Docker

También puedes ejecutar el servidor usando Docker. Primero, compila la imagen:

docker build -t mcp-server-serper .

Luego ejecuta el contenedor con tu clave de API de Serper:

docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

Alternativamente, si tienes tus variables de entorno en un archivo .env:

docker run --env-file .env mcp-server-serper

Para desarrollo, es posible que quieras montar tu código fuente como un volumen:

docker run -v $(pwd):/app --env-file .env mcp-server-serper

Nota: Asegúrate de reemplazar your_api_key_here con tu clave real de API de Serper.