tavily-search-mcp-server
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
Clona este repositorio en algún lugar de tu computadora:
git clone https://github.com/apappascs/tavily-search-mcp-server.gitInstalar dependencias y compilar el proyecto:
cd tavily-search-mcp-servernpm installnpm 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.jsonAgregue uno de los siguientes al objeto
mcpServersen su configuración, dependiendo de si desea ejecutar el servidor usandonpmodocker: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-servercon 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 claudeConfiguración del entorno (para npm)
Copiar
.env.examplea.env:cp .env.example .envActualice el archivo
.envcon su clave API de Tavily actual:TAVILY_API_KEY=your_api_key_hereNota: Nunca envíes tu clave API al control de versiones. Git ignora el archivo
.envpor seguridad.
Corriendo con NPM
Inicie el servidor usando Node.js:
node dist/index.jsPara transporte sse:
node dist/sse.jsEjecutando 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:latestPara transporte sse:
docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY="your_api_key_here" -e TRANSPORT="sse" tavily-search-mcp-server:latestTambié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:latestNota: El segundo comando muestra el enfoque recomendado: usar
-e TAVILY_API_KEY=$TAVILY_API_KEYpara pasar el valor de la variable de entornoTAVILY_API_KEYal 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 -dPara 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.
Available Tools
1 tooltavily_searchA
Performs a web search using the Tavily Search API, optimized for LLMs. Use this for broad information gathering, recent events, or when you need diverse web sources. Supports search depth, topic selection, time range filtering, and domain inclusion/exclusion.
Inputs: query (required), search_depth, topic, days, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'tavily_search' has a clear, distinct purpose focused on web search functionality.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'tavily_search' follows a clear and descriptive pattern.
One tool is too few for a server with a broad purpose like web search, as it lacks complementary operations such as filtering results, managing search history, or handling different search types. This minimal scope limits agent workflows and feels incomplete.
The tool surface is severely incomplete for a web search domain; it only provides a basic search function without supporting operations like refining searches, saving results, or accessing search metadata. This creates significant gaps that will hinder agent effectiveness.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
Unofficial Tavily MCP — wraps the Tavily API (tavily.com)
An MCP server that gives your AI access to the source code and docs of all public github repos
Related MCP Servers
- FlicenseCqualityDmaintenanceAn MCP protocol server that enables web search functionality using the Tavily API, allowing AI assistants to perform internet searches in real-time.44-
- AlicenseNot gradedqualityDmaintenanceMCP server for using various search tools like Tavily API. Planning to support various search tools (i.e. wiki search, searxng, etc)3MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables web search and document retrieval capabilities through Tavily API and LangConnect vector database, supporting AI agents in gathering information for comprehensive report generation.23-
- FlicenseBqualityDmaintenanceMCP server using Tavily API for web search, enabling web search queries via stdio transport.5-