Tavily

Servidor MCP de Tavily

Implementación del servidor MCP de Tavily que utiliza fastmcp y soporta tanto transporte sse como stdio. Para usar este servidor, necesitas una cuenta de Tavily y una clave de API de Tavily, que debe cargarse en la variable de entorno TAVILY_API_KEY.

El servidor MCP de Tavily proporciona:

• Herramientas de búsqueda, extracción, mapa y rastreo
• Capacidades de búsqueda web en tiempo real a través de la herramienta tavily-search
• Extracción inteligente de datos de páginas web mediante la herramienta tavily-extract
• Potente herramienta de mapeo web que crea un mapa estructurado del sitio web
• Rastreador web que explora sitios web sistemáticamente

Requisitos previos

• git instalado. (Para clonar el repositorio)
• uv instalado.
• docker instalado (Opcional: Si planeas usar el servidor SSE dentro de un contenedor docker).

Para instalar uv en Linux y MacOS, escribe esto en tu terminal:

curl -LsSf https://astral.sh/uv/install.sh | sh

Variables de entorno

Copia el archivo .env.example y renómbralo a .env. Luego pega tu TAVILY_API_KEY dentro de él.

TAVILY_API_KEY=<YOUR-API-KEY>

Opcional: También puedes configurar el puerto si planeas usar SSE.

TAVILY_MCP_PORT=<PORT>

Ejecutar el servidor SSE

Mientras estés dentro del repositorio, ejecuta:

uv run --env-file .env tavily-mcp-sse

Ejecutar en STDIO

{
  "mcpServers": {
    "tavily-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<LOCATION-TO-THE-REPO>",
        "tavily-mcp-stdio"
      ],
      "env": {
        "TAVILY_API_KEY": "<YOUR-API-KEY>"
      }
    }
  }
}

Servidor Docker SSE

Primero necesitas construir la imagen usando el Dockerfile dentro de este repositorio. Ejecuta esto para construir la imagen:

docker build -t tavily-mcp .

Luego puedes ejecutar el contenedor usando las variables de entorno dentro del archivo env.

docker run --name tavily-mcp \
  -p 127.0.0.1:8000:8000 \
  --env-file .env \
  tavily-mcp

O puedes especificar las variables de entorno tú mismo.

docker run --name tavily-mcp \
  -p 127.0.0.1:8000:8000 \
  -e TAVILY_API_KEY=<YOUR-API-KEY>
  tavily-mcp