A
securityA
licenseA
qualityAn MCP server implementation that integrates the SearxNG API, providing web search capabilities.
Last updated -
2
1,333
247
MIT License
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
.enven 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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Permite la integración de la funcionalidad de búsqueda de Google en aplicaciones habilitadas para MCP mediante la API Serper, lo que proporciona resultados de búsqueda enriquecidos, parámetros configurables y un manejo eficiente de respuestas.
- ✨ Características
- 🚀 Instalación
- ⚙️ Configuración
- 🔌 Integración
- 🛠 Uso
- 🔍Tipos de respuesta
- 📊 Métricas de calidad
- 🤝 Contribuyendo
- 📝 Licencia
- 🙏 Agradecimientos
Related Resources
Related MCP Servers
- -securityFlicense-qualityAn MCP server that integrates with SerpApi to retrieve search results from multiple search engines including Google, Bing, Yahoo, and others, enabling fast access to both live and archived search data.Last updated -16
- AsecurityAlicenseAqualityA powerful MCP server that enables parallel Google searching with multiple keywords simultaneously, providing structured results while handling CAPTCHAs and simulating user browsing patterns.Last updated -1169209MIT License
- -securityFlicense-qualityAn MCP Server that provides access to Google's Search Console API, allowing users to interact with website search performance data and manage search presence through natural language.Last updated -