Tavily Search MCP

Tavily Search MCP — это MCP-сервис на основе Streamable HTTP, который инкапсулирует возможности веб-поиска и извлечения содержимого веб-страниц Tavily в инструменты MCP.

Возможности

• web_search: выполнение веб-поиска по ключевым словам запроса.

• web_fetch: извлечение читаемого текстового содержимого по URL-адресу веб-страницы.

Related MCP server: tavily-mcp

Требования к окружению

• Python 3.11+

• Tavily API Key

• MCP-клиент с поддержкой streamable_http

Установка

Сначала создайте и активируйте собственное виртуальное окружение Python, затем установите зависимости и текущий проект:

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

Скопируйте шаблон переменных окружения:

cp .env.example .env

Заполните конфигурацию в .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=*

При развертывании на сервере установите MCP_SERVER_HOST в значение 0.0.0.0 и добавьте ваш публичный домен или имя хоста для доступа в MCP_ALLOWED_HOSTS.

Запуск сервиса

python -m tavily_search_mcp.server

Локальный адрес MCP по умолчанию:

http://127.0.0.1:21029/mcp

Проверка работоспособности:

curl http://127.0.0.1:21029/health

Тестовый клиент

Список инструментов MCP:

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

Вызов веб-поиска:

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

Вызов извлечения содержимого веб-страницы:

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

Конфигурация MCP-клиента

Пример локального сервиса:

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

Пример удаленного сервиса:

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

Развертывание на сервере

Вы можете использовать скрипт развертывания из репозитория, чтобы загрузить и запустить сервис с помощью вашего собственного SSH-ключа:

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