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.

Related MCP server: metasearch-mcp

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 :

npx -y @smithery/cli install @apappascs/tavily-search-mcp-server --client claude

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:

node dist/index.js

Para transporte sse:

node dist/sse.js

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 Compose

   Correr:

   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.