Tavily

Tavily MCP Server

Сервер Tavily MCP предоставляет:

• инструменты поиска, извлечения, построения карты сайта и сканирования
• Возможности поиска в реальном времени через инструмент tavily-search
• Интеллектуальное извлечение данных с веб-страниц с помощью инструмента tavily-extract
• Мощный инструмент построения карты сайта, создающий структурированную карту веб-сайта
• Веб-сканер, который систематически исследует веб-сайты

📚 Полезные ресурсы

• Руководство по объединению Tavily MCP с сервером Neo4j MCP
• Руководство по интеграции Tavily MCP с Cline в VS Code

Удаленный MCP-сервер

Подключайтесь напрямую к удаленному MCP-серверу Tavily вместо локального запуска. Это обеспечивает удобство работы без необходимости локальной установки или настройки.

Просто используйте URL удаленного MCP-сервера с вашим API-ключом Tavily:

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

Получите ваш API-ключ Tavily на tavily.com.

В качестве альтернативы вы можете передать свой API-ключ через заголовок Authorization, если MCP-клиент это поддерживает:

Authorization: Bearer <your-api-key>

Примечание: При использовании удаленного MCP вы можете указать параметры по умолчанию для всех запросов, включив заголовок DEFAULT_PARAMETERS, содержащий объект JSON с желаемыми значениями по умолчанию. Пример:

{"include_images":true, "search_depth": "basic", "max_results": 10}

Подключение к Claude Code

Claude Code — это официальный CLI-инструмент Anthropic для Claude. Вы можете добавить сервер Tavily MCP с помощью команды claude mcp add. Существует два способа аутентификации:

Вариант 1: API-ключ в URL

Передайте свой API-ключ непосредственно в URL. Замените <your-api-key> на ваш фактический API-ключ Tavily:

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

Вариант 2: Поток аутентификации OAuth

Добавьте сервер без API-ключа в URL:

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

После добавления вам потребуется завершить процесс аутентификации:

1. Запустите claude, чтобы запустить Claude Code
2. Введите /mcp, чтобы открыть управление MCP-сервером
3. Выберите сервер Tavily и завершите процесс аутентификации

Совет: Добавьте --scope user к любой из команд, чтобы сделать сервер Tavily MCP доступным глобально для всех ваших проектов:

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

После настройки вы получите доступ к инструментам поиска, извлечения, построения карты и сканирования Tavily.

Подключение к Cursor

Нажмите кнопку ⬆️ Add to Cursor ⬆️, это сделает большую часть работы за вас, но вам все равно потребуется отредактировать конфигурацию, чтобы добавить ваш API-KEY. Получить API-ключ Tavily можно здесь.

после нажатия кнопки вы должны быть перенаправлены в Cursor ...

Шаг 1

Нажмите кнопку установки

Шаг 2

Вы должны увидеть, что MCP теперь установлен. Если синий переключатель еще не включен, включите его вручную. Вам также необходимо отредактировать конфигурацию, чтобы включить ваш собственный API-ключ Tavily.

Шаг 3

Затем вы будете перенаправлены в ваш файл mcp.json, где вам нужно добавить your-api-key.

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

Поток OAuth удаленного MCP-сервера

Удаленный MCP-сервер Tavily поддерживает безопасную аутентификацию OAuth, позволяя вам подключаться и авторизоваться без проблем с совместимыми клиентами.

Как настроить аутентификацию OAuth

A. Использование MCP Inspector:

• Откройте MCP Inspector и нажмите «Open Auth Settings».
• Выберите поток OAuth и выполните следующие шаги:
  1. Обнаружение метаданных
  2. Регистрация клиента
  3. Подготовка авторизации
  4. Запрос авторизации и получение кода авторизации
  5. Запрос токена
  6. Аутентификация завершена

После завершения вы получите токен доступа, который позволит вам безопасно выполнять аутентифицированные запросы к удаленному MCP-серверу Tavily.

B. Использование других MCP-клиентов (Пример: Cursor):

Вы можете настроить свой MCP-клиент на использование OAuth без включения вашего API-ключа Tavily в URL. Например, в вашем mcp.json:

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

Если вам нужно очистить сохраненные учетные данные OAuth и пройти повторную аутентификацию, выполните:

rm -rf ~/.mcp-auth

Примечание:

• Аутентификация OAuth необязательна. Вы по-прежнему можете использовать аутентификацию по API-ключу в любое время, включив ваш API-ключ Tavily в параметр запроса URL (?tavilyApiKey=...) или установив его в заголовке Authorization, как описано выше.

Выбор используемого API-ключа для OAuth

После успешной аутентификации OAuth вы можете контролировать, какой API-ключ используется, назвав его mcp_auth_default:

• Если вы установите ключ с именем mcp_auth_default в вашей личной учетной записи, этот ключ будет использоваться для потока аутентификации.
• Если вы состоите в команде, у которой есть ключ с именем mcp_auth_default, этот ключ будет использоваться для потока аутентификации.
• Если у вас есть и личный ключ, и ключ команды с именем mcp_auth_default, приоритет будет у личного ключа.
• Если ключ mcp_auth_default не установлен, будет использован ключ default в вашей личной учетной записи. Если ключ default не установлен, будет использован первый доступный ключ.

Локальный MCP

Предварительные требования 🔧

Перед началом работы убедитесь, что у вас есть:

• API-ключ Tavily
  • Если у вас нет API-ключа Tavily, вы можете зарегистрировать бесплатную учетную запись здесь
• Claude Desktop или Cursor
• Node.js (v20 или выше)
  • Вы можете проверить установку Node.js, выполнив:
    • node --version
• Git установлен (требуется только при использовании метода установки через Git)
  • В macOS: brew install git
  • В Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • В Windows: Загрузите Git для Windows

Запуск с NPX

npx -y tavily-mcp@latest 

Настройка параметров по умолчанию ⚙️

Вы можете установить значения параметров по умолчанию для инструмента tavily-search, используя переменную окружения DEFAULT_PARAMETERS. Это позволяет настроить поведение поиска по умолчанию без указания этих параметров в каждом запросе.

Пример конфигурации

export DEFAULT_PARAMETERS='{"include_images": true}'

Пример использования из клиента

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

Идентификация конечного пользователя (необязательно)

Вы можете дополнительно идентифицировать конечного пользователя, от имени которого выполняются запросы, установив переменную окружения TAVILY_HUMAN_ID. Если она установлена, Tavily MCP передает ее в качестве заголовка X-Human-Id при каждом вызове API, что позволяет вести аналитику по пользователям.

Это полностью необязательно — оставьте переменную неустановленной, и поведение не изменится.

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

Примечание о конфиденциальности: Tavily хеширует human_id на стороне сервера (SHA-256) перед хранением, поэтому исходное значение никогда не сохраняется. Тем не менее, по возможности отдавайте предпочтение непрозрачным идентификаторам (например, внутреннему идентификатору пользователя), а не персональным данным, таким как адреса электронной почты.

Благодарности ✨

• Model Context Protocol за спецификацию MCP
• Anthropic за Claude Desktop