Servidor MCP de búsqueda de Tavily

Name: tavily-search-mcp-server
Author: apappascs

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: MCP2Tavily

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

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

3. Integración con Claude Desktop

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
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" } } } }
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 .
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)

Copiar .env.example a .env :
cp .env.example .env
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

Construya la imagen de Docker (si aún no lo ha hecho):
docker build -t tavily-search-mcp-server:latest .
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.
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.