Servidor MCP de búsqueda y raspado de Serper

Un servidor MCP basado en TypeScript que ofrece funciones de búsqueda web y extracción de contenido web mediante 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 - Realizar búsquedas web a través de la API de Serper

  • Resultados de búsqueda enriquecidos que incluyen resultados orgánicos, gráficos de conocimiento, "la gente también pregunta" y búsquedas relacionadas

  • Admite segmentación por región e idioma

  • Parámetros opcionales para ubicación, paginación, filtros de tiempo y autocorrección

  • Admite operadores de búsqueda avanzados:

    • site : Limitar los resultados a un dominio específico

    • filetype : limitar a tipos de archivos 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 exacta de frase

    • exclude : Términos para excluir de los resultados de búsqueda

    • or : Términos alternativos (operador OR)

• scrape - Extraer contenido de páginas web

  • Obtener texto sin formato y contenido Markdown opcional

  • Incluye JSON-LD y metadatos de encabezado

  • Conserva la estructura del documento

Related MCP server: go_serper_mcp_server

Requisitos

• Node.js >= 18

• Clave API de Serper (establecida como variable de entorno SERPER_API_KEY )

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucció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

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

Instalación

Instalación mediante herrería

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

Escritorio de Claude

Agregue la configuración del servidor en:

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

• Ventanas: %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. Abra la configuración de la extensión Cline

2. Abra la pestaña "Servidores MCP"

3. Haga clic en "Configurar servidores MCP"

4. Agregue 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 de configuración adicionales de Cline:

• disabled : establezca en false para habilitar el servidor

• autoApprove : Lista de herramientas que no requieren aprobación explícita para cada uso

Cursor

1. Abra la configuración del cursor

2. Abra la configuración de "Funciones"

3. En la sección "Servidores MCP", haga clic en "Agregar nuevo servidor MCP".

4. Elija un nombre y seleccione "comando" como "Tipo".

5. En el campo "Comando", ingrese lo siguiente:

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

Estibador

También puedes ejecutar el servidor con Docker. Primero, crea la imagen:

docker build -t mcp-server-serper .

Luego, ejecute el contenedor con su clave API de Serper:

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

Alternativamente, si tiene sus variables de entorno en un archivo .env :

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

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

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

Nota: asegúrese de reemplazar your_api_key_here con su clave API de Serper real.