Servidor MCP de búsqueda de Tavily

Una implementación de servidor MCP que integra la API de búsqueda de Tavily y proporciona capacidades de búsqueda optimizadas para LLM.

Características

• Búsqueda web: realice búsquedas web optimizadas para LLM, con control sobre la profundidad de búsqueda, el tema y el rango de tiempo.
• Extracción de contenido: extrae el contenido más relevante de los resultados de búsqueda, optimizándolo según la calidad y el tamaño.
• Características opcionales: incluya imágenes, descripciones de imágenes, respuestas breves generadas por LLM y contenido HTML sin formato.
• Filtrado de dominios: incluya o excluya dominios específicos en los resultados de búsqueda.

Herramientas

• búsqueda de tavily
  • Ejecute búsquedas web utilizando la API de búsqueda de Tavily.
  • Entradas:
    • query (cadena, obligatoria): la consulta de búsqueda.
    • search_depth (cadena, opcional): "básico" o "avanzado" (predeterminado: "básico").
    • topic (cadena, opcional): "general" o "noticias" (predeterminado: "general").
    • days (número, opcional): Número de días atrás para la búsqueda de noticias (predeterminado: 3).
    • time_range (cadena, opcional): filtro de rango de tiempo ("día", "semana", "mes", "año" o "d", "s", "m", "a").
    • max_results (número, opcional): Número máximo de resultados (predeterminado: 5).
    • include_images (booleano, opcional): incluye imágenes relacionadas (predeterminado: falso).
    • include_image_descriptions (booleano, opcional): incluye descripciones de las imágenes (valor predeterminado: falso).
    • include_answer (booleano, opcional): incluye una respuesta corta generada por LLM (valor predeterminado: falso).
    • include_raw_content (booleano, opcional): incluye contenido HTML sin procesar (predeterminado: falso).
    • include_domains (string[], opcional): Dominios a incluir.
    • exclude_domains (string[], opcional): Dominios a excluir.

Guía de configuración 🚀

1. Requisitos previos

• Claude Desktop instalado en su computadora.
• Clave API de Tavily: a. Crea una cuenta API de Tavily . b. Elige un plan (disponible en versión gratuita). c. Genera tu clave API desde el panel de Tavily.

2. Instalación

1. Clona este repositorio en algún lugar de tu computadora:
   git clone https://github.com/apappascs/tavily-search-mcp-server.git
2. Instalar dependencias y compilar el proyecto:
   cd tavily-search-mcp-server
   npm install
   npm run build

3. Integración con Claude Desktop

1. Abra el archivo de configuración de Claude Desktop:
   # On Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json # On Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Agregue uno de los siguientes al objeto mcpServers en su configuración, dependiendo de si desea ejecutar el servidor usando npm o docker :Opción A: Uso de NPM (transporte stdio)
   { "mcpServers": { "tavily-search-server": { "command": "node", "args": [ "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server/dist/index.js" ], "env": { "TAVILY_API_KEY": "your_api_key_here" } } } }
   Opción B: Uso de NPM (transporte SSE)
   { "mcpServers": { "tavily-search-server": { "command": "node", "args": [ "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server/dist/sse.js" ], "env": { "TAVILY_API_KEY": "your_api_key_here" }, "port": 3001 } } }
   Opción C: Usar Docker
   { "mcpServers": { "tavily-search-server": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "TAVILY_API_KEY", "-v", "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server:/app", "tavily-search-mcp-server" ], "env": { "TAVILY_API_KEY": "your_api_key_here" } } } }
3. Pasos importantes:
   • Reemplace /Users/<username>/<FULL_PATH...>/tavily-search-mcp-server con la ruta completa real al lugar donde clonó el repositorio.
   • Añade tu clave API de Tavily en la sección env . Siempre es recomendable tener secretos como las claves API como variables de entorno.
   • Asegúrese de utilizar barras diagonales ( / ) en la ruta, incluso en Windows.
   • Si está usando Docker, asegúrese de compilar la imagen primero usando docker build -t tavily-search-mcp-server:latest .
4. Reinicie Claude Desktop para que los cambios surtan efecto.

Instalación mediante herrería

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

Configuración del entorno (para npm)

1. Copiar .env.example a .env :
   cp .env.example .env
2. Actualice el archivo .env con su clave API de Tavily actual:
   TAVILY_API_KEY=your_api_key_here
   Nota: Nunca envíes tu clave API al control de versiones. Git ignora el archivo .env por seguridad.

Corriendo con NPM

Inicie el servidor usando Node.js:

Para transporte sse:

Ejecutando con Docker

1. Construya la imagen de Docker (si aún no lo ha hecho):
   docker build -t tavily-search-mcp-server:latest .
2. Ejecute el contenedor Docker con:Para el transporte de stdio:
   docker run -it --rm -e TAVILY_API_KEY="your_api_key_here" tavily-search-mcp-server:latest
   Para transporte sse:
   docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY="your_api_key_here" -e TRANSPORT="sse" tavily-search-mcp-server:latest
   También puedes aprovechar directamente las variables de entorno de tu shell, lo que es una práctica más segura:
   docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY=$TAVILY_API_KEY -e TRANSPORT="sse" tavily-search-mcp-server:latest
   Nota: El segundo comando muestra el enfoque recomendado: usar -e TAVILY_API_KEY=$TAVILY_API_KEY para pasar el valor de la variable de entorno TAVILY_API_KEY al contenedor Docker. Esto evita que la clave API se incluya en el historial de comandos y, por lo general, se prefiere a codificar los secretos en los comandos.
3. Usando Docker ComposeCorrer:
   docker compose up -d
   Para detener el servidor:
   docker compose down

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.