tavily_mcp

Tavily MCP – inteligentna wyszukiwarka internetowa dla AI

Otwarte i darmowe

Opis wtyczki Tavily MCP

Serwer Tavily MCP to wtyczka, która daje Twojemu asystentowi AI bezpośredni dostęp do internetu w czasie rzeczywistym. Dzięki niej sztuczna inteligencja nie musi polegać na nieaktualnych danych ze swojego treningu. Może na żywo przeszukiwać strony, czytać z nich informacje i tworzyć mapy całych witryn internetowych. To potężne narzędzie do robienia szybkiego i dokładnego researchu w sieci.

Dostępne narzędzia (tools):

  • tavily-search – wyszukiwanie w sieci w czasie rzeczywistym. AI znajduje dla Ciebie najnowsze informacje.
  • tavily-extract – inteligentne pobieranie konkretnych danych z wybranych stron internetowych.
  • tavily-map – tworzenie ustrukturyzowanej mapy podanej witryny internetowej, co ułatwia jej analizę.
  • tavily-crawl – systematyczne badanie i przeszukiwanie całej struktury stron.

Zasoby (resources):

  • Serwer udostępnia poradniki pokazujące integrację Tavily z wtyczką Neo4j oraz środowiskiem Cline w programie VS Code.

Jak to działa w praktyce?

Działanie tej wtyczki polega na inteligentnym delegowaniu zadań do wyszukiwarki. Przepływ wygląda następująco: Ty zadajesz pytanie → AI decyduje, co trzeba znaleźć → wtyczka MCP przeszukuje internet za pomocą Tavily → AI analizuje wyniki i daje Ci gotową odpowiedź.

Praktyczne przykłady użycia:

  • Analiza konkurencji: Prosisz AI o sprawdzenie aktualnych cenników na stronach trzech konkurentów. Wtyczka wchodzi na te strony, pobiera cenniki i przygotowuje dla Ciebie tabelę z porównaniem.
  • Zrozumienie struktury bloga: Chcesz wiedzieć, o czym pisze dana firma. Narzędzie do mapowania skanuje całego bloga i wypisuje Ci listę wszystkich artykułów.
  • Codzienne prasówki: Pytasz asystenta o dzisiejsze wiadomości ze swojej branży. AI w ułamku sekundy przeszukuje najnowsze publikacje w sieci i tworzy dla Ciebie zgrabne podsumowanie.

Instalacja wtyczki krok po kroku

Tavily MCP pozwala na połączenie zdalne (bez instalacji plików) lub lokalne na Twoim komputerze. Poniżej znajdziesz instrukcje dla najpopularniejszych programów.

Opcja 1: Alice (Połączenie zdalne – najprostsze)

Zdalne serwery dodajemy w Alice bezpośrednio przez prosty adres internetowy.
  1. Zdobądź darmowy klucz dostępu (API) na stronie tavily.com.
  2. W aplikacji Alice wejdź w Ustawienia -> MCP Servers -> Add New.
  3. Wybierz opcję Server Type – HTTP (Streamable).
  4. Wpisz adres połączenia (podmieniając końcówkę na Twój klucz): https://mcp.tavily.com/mcp/?tavilyApiKey=twój_klucz_api.
  5. Zapisz. Alice automatycznie połączy się z wtyczką i od razu możesz jej używać.

Opcja 2: ChatGPT (Aplikacje)

W ChatGPT wtyczki działają teraz jako zintegrowane Aplikacje (Apps).
  1. Przejdź do Settings (Ustawienia), a następnie kliknij Apps.
  2. Znajdź aplikację Tavily w katalogu dostępnych narzędzi.
  3. Kliknij Connect (Połącz), aby zalogować się i zautoryzować połączenie.
  4. Możesz teraz wywołać wtyczkę w czacie używając znaku @.

Opcja 3: Claude Desktop (Instalacja lokalna)

Ta metoda wymaga programu Node.js (wersja 20 lub nowsza). Edytujesz plik z ustawieniami na swoim komputerze.
  1. Otwórz plik konfiguracyjny claude_desktop_config.json.
  2. Wklej w nim poniższy format JSON, podmieniając your-api-key-here na własny klucz.
  3. Zapisz plik i uruchom ponownie aplikację Claude.
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@latest"],
"env": {
"TAVILY_API_KEY": "your-api-key-here",
"DEFAULT_PARAMETERS": "{"include_images": true, "max_results": 15, "search_depth": "advanced"}"
}
}
}
}

Opcja 4: Cursor IDE

  1. Kliknij przycisk instalacji “Add to Cursor” na stronie instalacyjnej, co przeniesie Cię do edytora.
  2. Upewnij się, że przełącznik wtyczki jest włączony.
  3. Edytuj plik mcp.json, podmieniając fragment <your-api-key> na swój właściwy klucz.
⚠️ Rozwiązywanie problemów: Błędy w połączeniu przez Cursor lub Claude wynikają najczęściej z braku ważnego klucza API lub błędu w składni pliku JSON (np. braku przecinka). Upewnij się, że wpisujesz klucz poprawnie i masz zainstalowany program Node.js.

Często zadawane pytania (FAQ)

Skąd wziąć klucz dostępu (API)?

Klucz API możesz wygenerować za darmo po założeniu konta na oficjalnej stronie tavily.com.

Czy muszę instalować coś na komputerze, by używać tej wtyczki?

Nie zawsze. Jeśli używasz zdalnego adresu połączenia (Remote MCP Server) w programach takich jak Alice, wszystko działa w chmurze i nie wymaga pobierania dodatkowych plików instalacyjnych.

Co zrobić, jeśli mam problem z logowaniem przez konto (OAuth)?

Jeśli logowanie OAuth się zablokuje, możesz wyczyścić zapisane poświadczenia używając okna poleceń (terminala) wpisując polecenie rm -rf ~/.mcp-auth. Następnie spróbuj zalogować się ponownie.

Czy mogę ustawić domyślne parametry wyszukiwania?

Tak. W instalacji lokalnej możesz użyć zmiennej “DEFAULT_PARAMETERS”, aby z góry określić na przykład to, czy narzędzie ma pobierać z internetu również zdjęcia (include_images).

SZYBKA INSTALACJA


Code
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}