Servidor MCP de búsqueda de Serper

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funciones de búsqueda de Google a través de la API de Serper, junto con una herramienta de investigación profunda basada en IA. Este servidor facilita la integración de funciones de búsqueda e investigación en sus aplicaciones compatibles con MCP.

✨ Características

🌐 Potente integración de búsqueda de Google a través de la API de Serper
🔄 Datos de respuesta de búsqueda enriquecidos que incluyen:
- Información del Gráfico de Conocimiento
- Resultados de búsqueda orgánicos
- Preguntas de "La gente también pregunta"
- Búsquedas relacionadas
🧠 Herramienta de investigación profunda impulsada por IA:
- Realiza una investigación iterativa de varios pasos
- Genera subconsultas para explorar temas a fondo.
- Sintetiza información de múltiples fuentes
- Proporciona citas para toda la información.
- Niveles de profundidad de investigación ajustables
- Métricas de calidad integradas para la mejora continua
🛠 Parámetros de búsqueda configurables:
- Segmentación por país
- Selección de idioma
- Personalización del recuento de resultados
- Opciones de autocorrección
Manejo seguro de claves API
⚡️ Limitación de velocidad y soporte de almacenamiento en caché
📝 Compatibilidad con TypeScript con definiciones de tipos completas
📊 Métricas de rendimiento integradas para optimizar resultados

🚀 Instalación

Clonar el repositorio:

git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server

Instalar dependencias:

pnpm install

Construir el servidor:

pnpm run build

⚙️ Configuración

Obtén tu clave API de Serper desde [Serper.dev]( https://serper.de
Cree un archivo .env en el directorio raíz:

# Required
SERPER_API_KEY=your_api_key_here

# Optional - Advanced Quality Metrics Configuration (pre-configured by default)
USAGE_METRICS_KEY=your-custom-metrics-key     # Optional
USAGE_PROJECT_ID=your-custom-project-id       # Optional
METRICS_ENDPOINT=https://your-custom-host.com # Optional
DISABLE_METRICS=false                         # Not recommended

Consulte TELEMETRY.md para obtener información detallada sobre:

Recopilación de métricas de calidad
Monitoreo del rendimiento
Análisis de uso
Configuración del panel de control
Mejora continua

🔌 Integración

Escritorio de Claude

Agregue la configuración del servidor a su configuración de Claude Desktop:

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

{
  "mcpServers": {
    "serper-search-server": {
      "command": "/path/to/serper-search-server/build/index.js",
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠 Uso

Herramienta de búsqueda

El servidor proporciona una potente herramienta de búsqueda con los siguientes parámetros:

{
  "query": string,          // Search query
  "numResults"?: number,    // Number of results (default: 10, max: 100)
  "gl"?: string,           // Country code (e.g., "us", "uk")
  "hl"?: string,           // Language code (e.g., "en", "es")
  "autocorrect"?: boolean, // Enable autocorrect (default: true)
  "type"?: "search"        // Search type (more types coming soon)
}

Herramienta de investigación profunda

Para necesidades de investigación más exhaustivas, el servidor proporciona una herramienta de investigación profunda que realiza una investigación de varios pasos con los siguientes parámetros:

{
  "query": string,          // Research query or question
  "depth"?: "basic" | "standard" | "deep",  // Research depth (default: "standard")
  "maxSources"?: number     // Maximum sources to include (default: 10)
}

La herramienta de investigación profunda:

Divide consultas complejas en subconsultas específicas
Ejecuta múltiples búsquedas para recopilar información completa
Utiliza IA para sintetizar información de múltiples fuentes
Formatear resultados con citas y referencias adecuadas
Adapta su estrategia de investigación en función de los resultados intermedios
Recopila métricas de calidad anónimas para mejorar los resultados de búsqueda.

Niveles de profundidad:

Básico: descripción general rápida (3-5 fuentes, ~5 min) Bueno para: hechos simples, definiciones rápidas, preguntas directas
Estándar: Análisis exhaustivo (5-10 fuentes, ~10 min) Bueno para: La mayoría de las necesidades de investigación, profundidad y velocidad equilibradas
Profundo: Investigación exhaustiva (más de 10 fuentes, ~15-20 min) Bueno para: Temas complejos, investigación académica, análisis exhaustivo

Ejemplo de respuesta de la herramienta de búsqueda

Los resultados de la búsqueda incluyen datos muy completos:

{
  "searchParameters": {
    "q": "apple inc",
    "gl": "us",
    "hl": "en",
    "autocorrect": true,
    "type": "search"
  },
  "knowledgeGraph": {
    "title": "Apple",
    "type": "Technology company",
    "website": "http://www.apple.com/",
    "description": "Apple Inc. is an American multinational technology company...",
    "attributes": {
      "Headquarters": "Cupertino, CA",
      "CEO": "Tim Cook (Aug 24, 2011–)",
      "Founded": "April 1, 1976, Los Altos, CA"
    }
  },
  "organic": [
    {
      "title": "Apple",
      "link": "https://www.apple.com/",
      "snippet": "Discover the innovative world of Apple...",
      "position": 1
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "What does Apple Inc mean?",
      "snippet": "Apple Inc., formerly Apple Computer, Inc....",
      "link": "https://www.britannica.com/topic/Apple-Inc"
    }
  ],
  "relatedSearches": [
    {
      "query": "Who invented the iPhone"
    }
  ]
}

🔍Tipos de respuesta

Gráfico de conocimiento

Contiene información de la entidad cuando está disponible:

Título y tipo
URL del sitio web
Descripción
Atributos clave

Resultados orgánicos

Lista de resultados de búsqueda que incluye:

Título y URL
Fragmento (descripción)
Posición en los resultados
Enlaces de sitio cuando estén disponibles

La gente también pregunta

Preguntas frecuentes relacionadas con la búsqueda:

Texto de la pregunta
Fragmento de respuesta
Enlace de origen

Búsquedas relacionadas

Lista de consultas de búsqueda relacionadas que los usuarios suelen realizar.

📊 Métricas de calidad

La herramienta Deep Research incluye métricas de calidad integradas:

Métricas del proceso de investigación
Monitoreo del rendimiento
Seguimiento de problemas
Patrones de uso
Indicadores de calidad de resultados

Consulte TELEMETRY.md para obtener información detallada sobre las métricas recopiladas para mejorar la calidad de la búsqueda.

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📝 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

API de Serper para proporcionar las capacidades de búsqueda de Google
Protocolo de contexto modelo para el marco MCP
PostHog para capacidades analíticas

Serper Search MCP Server

Integrations