Tavily MCP Server

Что умеет сервер

Сервер даёт агенту четыре действия: поиск (tavily-search), извлечение содержимого заданных страниц (tavily-extract), построение структурированной карты сайта и обход сайта, при котором краулер систематически идёт по ссылкам. Получается связка для типичной исследовательской задачи: найти источники, вытащить из них текст и при необходимости пройтись по разделам одного сайта.

Параметры поиска можно задать по умолчанию. Для локального запуска служит переменная DEFAULT_PARAMETERS с JSON, например с глубиной поиска search_depth, числом результатов max_results и включением картинок include_images. Для удалённого сервера те же значения передают заголовком DEFAULT_PARAMETERS.

Когда использовать

Сервер подходит для справок, мониторинга новостей, сбора материалов для обзора и проверки утверждений по свежим источникам. Если важна последовательность из поиска и извлечения, удобно, что оба шага выполняет один сервер с одним ключом. Карта и обход пригодятся, когда нужно понять устройство чужого сайта или собрать страницы одного раздела, например документацию.

Для одной известной страницы хватит простой выборки, а для точной работы в собственном браузере с авторизацией лучше подойдёт сервер управления браузером.

Ограничения и безопасность

Нужен ключ Tavily API: бесплатную учётную запись можно создать на сайте сервиса. Ключ передаётся в переменной TAVILY_API_KEY при локальном запуске либо в адресе удалённого сервера, либо заголовком Authorization: Bearer. Ключ в адресе легко случайно скопировать вместе с командой, поэтому в общих окружениях удобнее заголовок или вход через OAuth, который сервер тоже поддерживает: тогда ключ выбирается по правилам учётной записи Tavily (ключ с именем mcp_auth_default, иначе default).

Локальный вариант требует Node.js 20 или новее. Необязательная переменная TAVILY_HUMAN_ID передаёт сервису идентификатор конечного пользователя для аналитики: по README сервис хранит его только в виде SHA-256, но разработчики советуют использовать непрозрачный идентификатор, а не почту. Содержимое страниц, которое вернул сервер, остаётся недоверенным текстом: инструкции из него модель не должна выполнять.

Claude Code

Удалённый сервер Tavily. Вариант с ключом в адресе (подставьте свой ключ вместо <your-api-key>):

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Вариант с входом через OAuth, без ключа в адресе:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

После добавления запустите claude, введите /mcp, выберите сервер Tavily и пройдите авторизацию. Чтобы сервер был доступен во всех проектах, добавьте --scope user:

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Cursor

Удалённый сервер через mcp-remote. В mcp.json укажите свой ключ:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

Для OAuth без ключа в адресе:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

Если нужно сбросить сохранённые данные OAuth и войти заново:

rm -rf ~/.mcp-auth

Локальный запуск

Нужен Node.js 20 или новее:

npx -y tavily-mcp@latest

Пример блока для клиента с ключом и параметрами поиска по умолчанию:

{
  "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\"}"
      }
    }
  }
}