Skip to main content
Glama

Tavily MCP Server

Official
by tavily-ai
MIT License
6,005
403
  • Apple
  • Linux

Tavily Crawl Бета

Звезды репозитория GitHubнпмзначок кузнеца

🎉 Представляем tavily-crawl + tavily-map в версии 0.2.1! 🎉

Демонстрация MCP

Протокол контекста модели (MCP) — это открытый стандарт, который позволяет системам искусственного интеллекта беспрепятственно взаимодействовать с различными источниками данных и инструментами, обеспечивая безопасные двусторонние соединения.

Разработанный Anthropic, протокол контекста модели (MCP) позволяет помощникам ИИ, таким как Клод, легко интегрироваться с расширенными возможностями поиска и извлечения данных Tavily. Эта интеграция обеспечивает моделям ИИ доступ к веб-информации в режиме реального времени, дополненный сложными опциями фильтрации и функциями поиска, специфичными для домена.

Сервер Tavily MCP обеспечивает:

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

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

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

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

  • API-ключ Tavily
    • Если у вас нет ключа API Tavily, вы можете зарегистрировать бесплатную учетную запись здесь.
  • Клод Рабочий стол или Курсор
  • 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

Установка сервера Tavily MCP ⚡

Работает с NPX

npx -y tavily-mcp@0.2.1

Установка через Smithery

Чтобы автоматически установить Tavily MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @tavily-ai/tavily-mcp --client claude

Хотя вы можете запустить сервер сам по себе, он не особенно полезен в изоляции. Вместо этого вы должны интегрировать его в клиент MCP. Ниже приведен пример того, как настроить приложение Claude Desktop для работы с сервером tavily-mcp.

Настройка клиентов MCP ⚙️

В этом репозитории объясняется, как настроить VS Code , Cursor и Claude Desktop для работы с сервером tavily-mcp.

Настройка VS Code 💻

Для установки в один клик нажмите одну из кнопок установки ниже:

Ручная установка

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

Добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P (или Cmd + Shift + P на macOS) и введя Preferences: Open User Settings (JSON) .

{ "mcp": { "inputs": [ { "type": "promptString", "id": "tavily_api_key", "description": "Tavily API Key", "password": true } ], "servers": { "tavily": { "command": "npx", "args": ["-y", "tavily-mcp@0.2.1"], "env": { "TAVILY_API_KEY": "${input:tavily_api_key}" } } } } }

При желании вы можете добавить его в файл .vscode/mcp.json в своей рабочей области:

{ "inputs": [ { "type": "promptString", "id": "tavily_api_key", "description": "Tavily API Key", "password": true } ], "servers": { "tavily": { "command": "npx", "args": ["-y", "tavily-mcp@0.2.1"], "env": { "TAVILY_API_KEY": "${input:tavily_api_key}" } } } }

Настройка Cline 🤖

Самый простой способ настроить сервер Tavily MCP в Cline — через Marketplace одним щелчком мыши:

  1. Откройте Cline в VS Code
  2. Нажмите на значок Клайна на боковой панели.
  3. Перейдите на вкладку «Серверы MCP» (4 квадрата).
  4. Найдите «Tavily» и нажмите «установить».
  5. При появлении запроса введите свой ключ API Tavily.

Кроме того, вы можете вручную настроить сервер Tavily MCP в Cline:

  1. Откройте файл настроек Cline MCP:

Для macOS:

# Using Visual Studio Code code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json # Or using TextEdit open -e ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Для Windows:

code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  1. Добавьте конфигурацию сервера Tavily в файл:Замените your-api-key-here на ваш фактический ключ API Tavily .
    { "mcpServers": { "tavily-mcp": { "command": "npx", "args": ["-y", "tavily-mcp@0.2.1"], "env": { "TAVILY_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": [] } } }
  2. Сохраните файл и перезапустите Cline, если он уже запущен.
  3. При использовании Cline вы теперь получите доступ к инструментам Tavily MCP. Вы можете попросить Cline использовать инструменты tavily-search и tavily-extract прямо в ваших разговорах.

Настройка курсора 🖥️

Примечание : требуется версия Cursor 0.45.6 или выше.

Чтобы настроить сервер Tavily MCP в Cursor:

  1. Открыть настройки курсора
  2. Перейдите в раздел «Функции» > «Серверы MCP».
  3. Нажмите кнопку «+ Добавить новый сервер MCP».
  4. Заполните следующую информацию:
    • Имя : Введите псевдоним для сервера (например, «tavily-mcp»).
    • Тип : выберите «команда» в качестве типа.
    • Команда : Введите команду для запуска сервера:
      env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@0.2.1

      Важно : замените your-api-key на ваш ключ API Tavily. Вы можете получить его на app.tavily.com/home

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

Composer Agent автоматически использует инструменты Tavily MCP, когда это релевантно вашим запросам. Лучше явно запросить использование инструментов, описав, что вы хотите сделать (например, «Пользователь tavily-search для поиска в Интернете последних новостей об ИИ»). На Mac нажмите command + L, чтобы открыть чат, выберите опцию composer в верхней части экрана, рядом с кнопкой отправки выберите agent и отправьте запрос, когда он будет готов.

Пример интерфейса курсора

Настройка приложения Claude Desktop 🖥️

Для macOS:

# Create the config file if it doesn't exist touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json" # Opens the config file in TextEdit open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json" # Alternative method using Visual Studio Code (requires VS Code to be installed) code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Для Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Добавьте конфигурацию сервера Tavily:

Замените your-api-key-here на ваш фактический ключ API Tavily .

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

2. Установка Git

  1. Клонируйте репозиторий:
git clone https://github.com/tavily-ai/tavily-mcp.git cd tavily-mcp
  1. Установить зависимости:
npm install
  1. Создайте проект:
npm run build

Настройка приложения Claude Desktop ⚙️

Выполните шаги настройки, описанные в разделе «Настройка приложения Claude Desktop» выше, используя приведенную ниже конфигурацию JSON.

Замените your-api-key-here на ваш фактический ключ API Tavily , а /path/to/tavily-mcp на фактический путь, по которому вы клонировали репозиторий в своей системе.

{ "mcpServers": { "tavily": { "command": "npx", "args": ["/path/to/tavily-mcp/build/index.js"], "env": { "TAVILY_API_KEY": "your-api-key-here" } } } }

Использование в приложении Claude Desktop 🎯

После завершения установки и настройки приложения Claude для рабочего стола необходимо полностью закрыть и снова открыть приложение Claude для рабочего стола, чтобы увидеть сервер tavily-mcp. В левом нижнем углу приложения должен быть значок молотка, указывающий на доступные инструменты MCP. Вы можете нажать на значок молотка, чтобы увидеть больше подробностей об инструментах tavily-search и tavily-extract.

Альтернативный текст

Теперь claude будет иметь полный доступ к серверу tavily-mcp, включая инструменты tavily-search и tavily-extract. Если вы вставите приведенные ниже примеры в приложение Claude для рабочего стола, вы должны увидеть инструменты сервера tavily-mcp в действии.

Примеры поиска Tavily

  1. Общий поиск в Интернете :
Can you search for recent developments in quantum computing?
  1. Поиск новостей :
Search for news articles about AI startups from the last 7 days.
  1. Поиск по домену :
Search for climate change research on nature.com and sciencedirect.com

Примеры извлечения Тавилы

  1. Извлечь содержание статьи :
Extract the main content from this article: https://example.com/article

✨ Объедините поиск и извлечение ✨

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

Search for news articles about AI startups from the last 7 days and extract the main content from each article to generate a detailed report.

Устранение неполадок 🛠️

Общие проблемы

  1. Сервер не найден
    • Проверьте установку npm, запустив npm --verison
    • Проверьте синтаксис конфигурации Claude Desktop, выполнив code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • Убедитесь, что Node.js установлен правильно, запустив node --version
  2. Проблемы, связанные с NPX
  • Если вы столкнулись с ошибками, связанными с npx , вам может потребоваться использовать полный путь к исполняемому файлу npx.
  • Вы можете найти этот путь, запустив which npx в своем терминале, а затем заменив строку "command": "npx" на "command": "/full/path/to/npx" в своей конфигурации.
  1. Проблемы с ключами API
    • Подтвердите, что ваш ключ API Tavily действителен
    • Проверьте правильность установки ключа API в конфигурации.
    • Убедитесь, что вокруг ключа API нет пробелов и кавычек.

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Этот сервер позволяет системам искусственного интеллекта интегрироваться с инструментами поиска и извлечения данных Tavily, обеспечивая доступ к веб-информации в режиме реального времени и поиск по домену.

  1. 🎉 Представляем tavily-crawl + tavily-map в версии 0.2.1! 🎉
    1. 📚 Полезные ресурсы
  2. Предварительные условия 🔧
    1. Установка сервера Tavily MCP ⚡
      1. Работает с NPX
      2. Установка через Smithery
    2. Настройка клиентов MCP ⚙️
      1. Настройка VS Code 💻
      2. Ручная установка
      3. Настройка Cline 🤖
      4. Для macOS:
      5. Для Windows:
      6. Настройка курсора 🖥️
      7. Настройка приложения Claude Desktop 🖥️
      8. Для macOS:
      9. Для Windows:
      10. Добавьте конфигурацию сервера Tavily:
      11. Установка Git
      12. Настройка приложения Claude Desktop ⚙️
    3. Использование в приложении Claude Desktop 🎯
      1. Примеры поиска Tavily
      2. Примеры извлечения Тавилы
      3. ✨ Объедините поиск и извлечение ✨
    4. Устранение неполадок 🛠️
      1. Общие проблемы
    5. Благодарности ✨

      Related MCP Servers

      • A
        security
        F
        license
        A
        quality
        This server allows users to perform web searches using Perplexity AI, providing a tool for retrieving search results through a simple API interface.
        Last updated -
        1
        2
        TypeScript
      • A
        security
        A
        license
        A
        quality
        A server that provides web scraping and intelligent content searching capabilities using the Firecrawl API, enabling AI agents to extract structured data from websites and perform content searches.
        Last updated -
        5
        2
        TypeScript
        MIT License
        • Apple
        • Linux
      • A
        security
        F
        license
        A
        quality
        An MCP protocol server that enables web search functionality using the Tavily API, allowing AI assistants to perform internet searches in real-time.
        Last updated -
        4
        2
        Python
      • -
        security
        A
        license
        -
        quality
        Provides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.
        Last updated -
        53
        Python
        MIT License
        • Linux
        • Apple

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/tavily-ai/tavily-mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server