MCP Tavily Search Server

búsqueda mcp-tavily

⚠️ Aviso

Este repositorio ya no se mantiene.

La funcionalidad de esta herramienta ahora está disponible en mcp-omnisearch , que combina múltiples herramientas MCP en un paquete unificado.

Utilice mcp-omnisearch en su lugar.

Un servidor de Protocolo de Contexto de Modelo (MCP) para integrar la API de búsqueda de Tavily con LLM. Este servidor proporciona funciones de búsqueda web inteligente optimizadas para obtener resultados factuales de alta calidad, incluyendo la generación de contexto para aplicaciones RAG y la respuesta directa a preguntas.

Características

• 🔍 Capacidades de búsqueda web avanzadas a través de la API de Tavily
• 🤖 Resúmenes de resultados de búsqueda generados por IA
• 🎯 Filtrado de dominios para obtener resultados de mayor calidad
• 📊 Profundidad de búsqueda y parámetros configurables
• 🧠 Generación de contexto para aplicaciones RAG
• ❓ Capacidad de responder preguntas directas
• 💾 Almacenamiento en caché de respuestas con soporte TTL
• 📝 Múltiples formatos de respuesta (texto, JSON, markdown)
• 🔄 Formato de resultados estructurado optimizado para LLM
• 🏗️ Construido sobre el Protocolo de Contexto Modelo

Configuración

Este servidor requiere configuración a través de su cliente MCP. A continuación, se muestran ejemplos para diferentes entornos:

Configuración de Cline

Agregue esto a su configuración de Cline MCP:

Escritorio Claude con configuración WSL

Para entornos WSL, agregue esto a su configuración de Claude Desktop:

Variables de entorno

El servidor requiere la siguiente variable de entorno:

• TAVILY_API_KEY : Su clave API de Tavily (obligatoria)

API

El servidor implementa tres herramientas MCP con parámetros configurables:

búsqueda de tavily

Busque en la web utilizando la API de búsqueda de Tavily, optimizada para obtener resultados objetivos y de alta calidad.

Parámetros:

• query (cadena, obligatoria): Consulta de búsqueda
• search_depth (cadena, opcional): "básico" (más rápido) o "avanzado" (más exhaustivo). El valor predeterminado es "básico".
• topic (cadena, opcional): "general" o "noticias". El valor predeterminado es "general".
• days (número, opcional): Número de días que se buscaron (solo noticias). El valor predeterminado es 3.
• time_range (cadena, opcional): rango de tiempo para los resultados ('día', 'semana', 'mes', 'año' o 'd', 's', 'm', 'a')
• max_results (número, opcional): Número máximo de resultados. El valor predeterminado es 5.
• include_answer (booleano, opcional): Incluye el resumen generado por IA. El valor predeterminado es verdadero.
• include_images (booleano, opcional): Incluye imágenes relacionadas. El valor predeterminado es falso.
• include_image_descriptions (booleano, opcional): Incluye descripciones de imágenes. El valor predeterminado es falso.
• include_raw_content (booleano, opcional): Incluye contenido HTML sin procesar. El valor predeterminado es falso.
• include_domains (string[], opcional): Lista de dominios confiables para incluir
• exclude_domains (string[], opcional): Lista de dominios a excluir
• response_format (cadena, opcional): 'texto', 'json' o 'markdown'. El valor predeterminado es 'texto'.
• cache_ttl (número, opcional): Tiempo de vida de la caché en segundos. El valor predeterminado es 3600.
• force_refresh (booleano, opcional): Fuerza la actualización de los resultados ignorando la caché. El valor predeterminado es falso.

tavily_obtener_contexto_de_búsqueda

Genere contexto para aplicaciones RAG utilizando la búsqueda Tavily.

Parámetros:

• query (cadena, obligatoria): consulta de búsqueda para la generación de contexto
• max_tokens (número, opcional): Longitud máxima del contexto generado. El valor predeterminado es 2000.
• search_depth (cadena, opcional): "básico" o "avanzado". El valor predeterminado es "avanzado".
• topic (cadena, opcional): "general" o "noticias". El valor predeterminado es "general".
• Otros parámetros iguales a tavily_search

búsqueda de tavily_qna

Obtenga respuestas directas a sus preguntas mediante la búsqueda de Tavily.

Parámetros:

• query (cadena, obligatoria): Pregunta a responder
• include_sources (booleano, opcional): Incluye citas de fuentes. El valor predeterminado es verdadero.
• search_depth (cadena, opcional): "básico" o "avanzado". El valor predeterminado es "avanzado".
• topic (cadena, opcional): "general" o "noticias". El valor predeterminado es "general".
• Otros parámetros iguales a tavily_search

Filtrado de dominios

El servidor admite un filtrado de dominio flexible a través de dos parámetros opcionales:

• include_domains : Matriz de dominios confiables para incluir en los resultados de búsqueda
• exclude_domains : Matriz de dominios para excluir de los resultados de búsqueda

Esto le permite:

• Dirigirse a fuentes confiables específicas para búsquedas académicas o técnicas
• Excluir fuentes potencialmente poco fiables o irrelevantes
• Personalice las fuentes según sus necesidades específicas
• Acceda a todas las fuentes disponibles cuando no se especifique ningún filtrado

Ejemplo de filtrado de dominio:

Desarrollo

Configuración

1. Clonar el repositorio
2. Instalar dependencias:

3. Construir el proyecto:

4. Ejecutar en modo de desarrollo:

Publicación

El proyecto utiliza conjuntos de cambios para la gestión de versiones. Para publicar:

1. Crear un conjunto de cambios:

2. Versionar el paquete:

3. Publicar en npm:

Contribuyendo

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

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Expresiones de gratitud

• Construido sobre el Protocolo de Contexto Modelo
• Desarrollado por la API de búsqueda de Tavily