Tavily

Servidor MCP Tavily

Implementação do servidor MCP Tavily que usa fastmcp e suporta os transportes sse e stdio. Para usar este servidor, você precisa de uma conta Tavily e uma chave de API Tavily, que deve ser carregada na variável de ambiente TAVILY_API_KEY.

O servidor MCP Tavily fornece:

• Ferramentas de busca, extração, mapa e rastreamento
• Capacidades de busca web em tempo real através da ferramenta tavily-search
• Extração inteligente de dados de páginas web através da ferramenta tavily-extract
• Ferramenta poderosa de mapeamento web que cria um mapa estruturado do site
• Rastreador web que explora sites sistematicamente

Pré-requisitos

• git instalado. (Para clonar o repositório)
• uv instalado.
• docker instalado (Opcional: Se você planeja usar o servidor SSE dentro de um contêiner docker).

Para instalar o uv no Linux e MacOS, digite isto no seu terminal:

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

Variáveis de Ambiente

Copie o arquivo .env.example e renomeie para .env. Em seguida, cole sua TAVILY_API_KEY dentro dele

TAVILY_API_KEY=<YOUR-API-KEY>

Opcional: Você também pode configurar a porta se planeja usar SSE.

TAVILY_MCP_PORT=<PORT>

Executando o servidor SSE

Dentro do repositório, execute:

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

Executando no 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

Primeiro, você precisa construir a imagem usando o Dockerfile dentro deste repositório. Execute isto para construir a imagem:

docker build -t tavily-mcp .

Em seguida, você pode executar o contêiner usando as variáveis de ambiente dentro do arquivo env

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

Ou você pode especificar as variáveis de ambiente você mesmo.

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