Tavily Search MCP

Tavily Search MCP es un servicio MCP basado en Streamable HTTP que encapsula las capacidades de búsqueda en línea y extracción de contenido web de Tavily como herramientas MCP.

Funciones

• web_search: Realiza búsquedas en línea según palabras clave de consulta.

• web_fetch: Extrae contenido de texto legible según la URL de una página web.

Related MCP server: tavily-mcp

Requisitos del entorno

• Python 3.11+

• Tavily API Key

• Cliente MCP compatible con streamable_http

Instalación

Primero, crea y activa tu propio entorno virtual de Python, luego instala las dependencias y el proyecto actual:

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

Copia la plantilla de variables de entorno:

cp .env.example .env

Rellena la configuración en .env:

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=*

Si se implementa en un servidor, establece MCP_SERVER_HOST en 0.0.0.0 y añade tu dominio público o nombre de host de acceso a MCP_ALLOWED_HOSTS.

Iniciar el servicio

python -m tavily_search_mcp.server

Dirección MCP local predeterminada:

http://127.0.0.1:21029/mcp

Verificación de salud:

curl http://127.0.0.1:21029/health

Cliente de prueba

Listar las herramientas MCP:

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

Llamar a la búsqueda en línea:

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

Llamar a la extracción de contenido web:

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

Configuración del cliente MCP

Ejemplo de servicio local:

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

Ejemplo de servicio remoto:

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

Implementación en servidor

Puedes usar el script de implementación del repositorio para cargar e iniciar el servicio mediante tu propia clave SSH:

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