MCP Tavily

Pesquisa web avançada e extração de conteúdo usando a API Tavily.

GitHub
12
Experimente este MCPPatrocinado

Documentação

MCP Tavily

smithery badge

Documentação em Chinês

Uma implementação de servidor Model Context Protocol (MCP) para a API Tavily, fornecendo recursos avançados de busca e extração de conteúdo.

Recursos

  • Múltiplas Ferramentas de Busca:
    • search: Funcionalidade básica de busca com opções personalizáveis
    • searchContext: Busca sensível ao contexto para melhor relevância
    • searchQNA: Busca focada em perguntas e respostas
  • Extração de Conteúdo: Extraia conteúdo de URLs com opções configuráveis
  • Opções de Configuração Ricas: Opções extensas para profundidade de busca, filtragem e inclusão de conteúdo

Uso com MCP

Adicione o servidor MCP Tavily à sua configuração MCP:

{ "mcpServers": { "tavily": { "command": "npx", "args": ["-y", "@mcptools/mcp-tavily"], "env": { "TAVILY_API_KEY": "sua-chave-de-api" } } } }

Nota: Certifique-se de substituir your-api-key pela sua chave real da API Tavily. Você também pode defini-la como uma variável de ambiente TAVILY_API_KEY antes de executar o servidor.

Referência da API

Ferramentas de Busca

O servidor fornece três ferramentas de busca que podem ser chamadas através do MCP:

1. Busca Básica

// Nome da ferramenta: search { query: "inteligência artificial", options: { searchDepth: "advanced", topic: "news", maxResults: 10 } }

2. Busca por Contexto

// Nome da ferramenta: searchContext { query: "últimos desenvolvimentos em IA", options: { topic: "news", timeRange: "week" } }

3. Busca de Perguntas e Respostas

// Nome da ferramenta: searchQNA { query: "O que é computação quântica?", options: { includeAnswer: true, maxResults: 5 } }

Ferramenta de Extração

// Nome da ferramenta: extract { urls: ["https://example.com/article1", "https://example.com/article2"], options: { extractDepth: "advanced", includeImages: true } }

Opções de Busca

Todas as ferramentas de busca compartilham estas opções:

interface SearchOptions { searchDepth?: "basic" | "advanced"; // Nível de profundidade da busca topic?: "general" | "news" | "finance"; // Categoria do tópico de busca days?: number; // Número de dias para buscar maxResults?: number; // Número máximo de resultados includeImages?: boolean; // Incluir imagens nos resultados includeImageDescriptions?: boolean; // Incluir descrições de imagens includeAnswer?: boolean; // Incluir resposta nos resultados includeRawContent?: boolean; // Incluir conteúdo bruto includeDomains?: string[]; // Lista de domínios a incluir excludeDomains?: string[]; // Lista de domínios a excluir maxTokens?: number; // Número máximo de tokens timeRange?: "year" | "month" | "week" | "day" | "y" | "m" | "w" | "d"; // Intervalo de tempo para a busca }

Opções de Extração

interface ExtractOptions { extractDepth?: "basic" | "advanced"; // Nível de profundidade da extração includeImages?: boolean; // Incluir imagens nos resultados }

Formato de Resposta

Todas as ferramentas retornam respostas no seguinte formato:

{ content: Array<{ type: "text", text: string }> }

Para resultados de busca, cada item inclui:

  • Título
  • Conteúdo
  • URL

Para conteúdo extraído, cada item inclui:

  • URL
  • Conteúdo bruto
  • Lista de URLs com falha (se houver)

Tratamento de Erros

Todas as ferramentas incluem tratamento adequado de erros e lançarão mensagens de erro descritivas se algo der errado.

Instalação

Instalando via Smithery

Para instalar o Servidor da API Tavily para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @kshern/mcp-tavily --client claude

Instalação Manual

npm install @mcptools/mcp-tavily

Ou use diretamente com npx:

npx @mcptools/mcp-tavily

Pré-requisitos

  • Node.js 16 ou superior
  • npm ou yarn
  • Chave da API Tavily (obtenha uma no Tavily)

Configuração

  1. Clone o repositório
  2. Instale as dependências:

npm install

  1. Defina sua chave da API Tavily:

export TAVILY_API_KEY=sua_chave_de_api

Compilação

npm run build

Depuração com MCP Inspector

Para desenvolvimento e depuração, recomendamos usar o MCP Inspector, uma ferramenta de desenvolvimento poderosa para servidores MCP.

O Inspector fornece uma interface de usuário para:

  • Testar chamadas de ferramentas
  • Visualizar respostas do servidor
  • Depurar a execução de ferramentas
  • Monitorar o estado do servidor

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/AmazingFeature)
  3. Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
  4. Envie para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

Licença

Este projeto é licenciado sob a Licença MIT.

Suporte

Para quaisquer perguntas ou problemas:

  • API Tavily: consulte a documentação do Tavily
  • Integração MCP: consulte a documentação do MCP