Tavily Search MCP

Tavily Search MCP ist ein MCP-Dienst auf Basis von Streamable HTTP, der Tavilys Websuche und Webseiten-Inhaltsextraktion als MCP-Tools bereitstellt.

Funktionen

• web_search: Führt eine Websuche basierend auf dem Suchbegriff durch.

• web_fetch: Extrahiert lesbaren Textinhalt von einer Webseiten-URL.

Related MCP server: tavily-mcp

Systemanforderungen

• Python 3.11+

• Tavily API Key

• MCP-Client mit Unterstützung für streamable_http

Installation

Erstelle und aktiviere zuerst deine eigene virtuelle Python-Umgebung und installiere dann die Abhängigkeiten und das aktuelle Projekt:

python -m pip install -r requirements.txt
python -m pip install -e .

Kopiere die Vorlage für die Umgebungsvariablen:

cp .env.example .env

Fülle die Konfiguration in .env aus:

TAVILY_API_KEY=tvly-your-api-key
MCP_SERVER_HOST=127.0.0.1
MCP_SERVER_PORT=21029
MCP_SERVER_PATH=/mcp
MCP_ALLOWED_HOSTS=127.0.0.1,127.0.0.1:21029,localhost,localhost:21029
MCP_ALLOWED_ORIGINS=*

Wenn du auf einem Server bereitstellst, setze MCP_SERVER_HOST auf 0.0.0.0 und füge deine öffentliche Domain oder den Zugriffshostnamen zu MCP_ALLOWED_HOSTS hinzu.

Dienst starten

python -m tavily_search_mcp.server

Standardmäßige lokale MCP-Adresse:

http://127.0.0.1:21029/mcp

Gesundheitscheck:

curl http://127.0.0.1:21029/health

Testclient

MCP-Tools auflisten:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp list-tools

Websuche aufrufen:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp web-search "Tavily Python SDK" --max-results 2

Webseiten-Inhaltsextraktion aufrufen:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp web-fetch "https://docs.tavily.com/"

MCP-Client-Konfiguration

Beispiel für lokalen Dienst:

{
  "mcpServers": {
    "tavily-search": {
      "type": "streamable_http",
      "url": "http://127.0.0.1:21029/mcp",
      "headers": {}
    }
  }
}

Beispiel für Remote-Dienst:

{
  "mcpServers": {
    "tavily-search": {
      "type": "streamable_http",
      "url": "https://your-domain.example/mcp",
      "headers": {}
    }
  }
}

Auf dem Server bereitstellen

Du kannst das Bereitstellungsskript im Repository verwenden, um den Dienst über deinen eigenen SSH-Key hochzuladen und zu starten:

.\scripts\deploy_remote.ps1 -HostName "your-server.example" -User "ubuntu" -IdentityFile "<path-to-private-key>"