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

Протокол контекста модели (MCP) — это открытый стандарт, который позволяет системам искусственного интеллекта беспрепятственно взаимодействовать с различными источниками данных и инструментами, обеспечивая безопасные двусторонние соединения.
Разработанный Anthropic, протокол контекста модели (MCP) позволяет помощникам ИИ, таким как Клод, легко интегрироваться с расширенными возможностями поиска и извлечения данных Tavily. Эта интеграция обеспечивает моделям ИИ доступ к веб-информации в режиме реального времени, дополненный сложными опциями фильтрации и функциями поиска, специфичными для домена.
Сервер Tavily MCP обеспечивает:
инструменты поиска, извлечения, сопоставления, сканирования
Возможности веб-поиска в режиме реального времени с помощью инструмента tavily-search
Интеллектуальное извлечение данных с веб-страниц с помощью инструмента tavily-extract
Мощный инструмент веб-картографии, который создает структурированную карту веб-сайта.
Веб-сканер, который систематически исследует веб-сайты
📚 Полезные ресурсы
Учебное пособие по объединению Tavily MCP с сервером Neo4j MCP
Учебник по интеграции Tavily MCP с Cline в VS Code
Related MCP server: Tavily MCP Server
Предварительные условия 🔧
Прежде чем начать, убедитесь, что у вас есть:
Если у вас нет ключа API Tavily, вы можете зарегистрировать бесплатную учетную запись здесь.
Node.js (v20 или выше)
Вы можете проверить установку Node.js, выполнив:
node --version
Установлен Git (требуется только при использовании метода установки Git)
На macOS:
brew install gitВ Linux:
Debian/Ubuntu:
sudo apt install gitRedHat/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 одним щелчком мыши:
Откройте Cline в VS Code
Нажмите на значок Клайна на боковой панели.
Перейдите на вкладку «Серверы MCP» (4 квадрата).
Найдите «Tavily» и нажмите «установить».
При появлении запроса введите свой ключ API Tavily.
Кроме того, вы можете вручную настроить сервер Tavily MCP в Cline:
Откройте файл настроек 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Добавьте конфигурацию сервера 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": [] } } }Сохраните файл и перезапустите Cline, если он уже запущен.
При использовании Cline вы теперь получите доступ к инструментам Tavily MCP. Вы можете попросить Cline использовать инструменты tavily-search и tavily-extract прямо в ваших разговорах.
Настройка курсора 🖥️
Примечание : требуется версия Cursor 0.45.6 или выше.
Чтобы настроить сервер Tavily MCP в Cursor:
Открыть настройки курсора
Перейдите в раздел «Функции» > «Серверы MCP».
Нажмите кнопку «+ Добавить новый сервер MCP».
Заполните следующую информацию:
Имя : Введите псевдоним для сервера (например, «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
Клонируйте репозиторий:
git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcpУстановить зависимости:
npm installСоздайте проект:
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
Общий поиск в Интернете :
Can you search for recent developments in quantum computing?Поиск новостей :
Search for news articles about AI startups from the last 7 days.Поиск по домену :
Search for climate change research on nature.com and sciencedirect.comПримеры извлечения Тавилы
Извлечь содержание статьи :
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.Устранение неполадок 🛠️
Общие проблемы
Сервер не найден
Проверьте установку npm, запустив
npm --verisonПроверьте синтаксис конфигурации Claude Desktop, выполнив
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonУбедитесь, что Node.js установлен правильно, запустив
node --version
Проблемы, связанные с NPX
Если вы столкнулись с ошибками, связанными с
npx, вам может потребоваться использовать полный путь к исполняемому файлу npx.Вы можете найти этот путь, запустив
which npxв своем терминале, а затем заменив строку"command": "npx"на"command": "/full/path/to/npx"в своей конфигурации.
Проблемы с ключами API
Подтвердите, что ваш ключ API Tavily действителен
Проверьте правильность установки ключа API в конфигурации.
Убедитесь, что вокруг ключа API нет пробелов и кавычек.
Благодарности ✨
Модель контекстного протокола для спецификации MCP
Антропный для Клода Десктопа
Available Tools
4 toolstavily-crawlA
A powerful web crawler that initiates a structured web crawl starting from a specified base URL. The crawler expands from that point like a graph, following internal links across pages. You can control how deep and wide it goes, and guide it to focus on specific sections of the site.
Inputs: url (required), max_depth, max_breadth, limit, +7 more.
tavily-extractC
A powerful web content extraction tool that retrieves and processes raw content from specified URLs, ideal for data collection, content analysis, and research tasks.
Inputs: urls (required), extract_depth, include_images, format, +2 more.
tavily-mapB
A powerful web mapping tool that creates a structured map of website URLs, allowing you to discover and analyze site structure, content organization, and navigation paths. Perfect for site audits, content discovery, and understanding website architecture.
Inputs: url (required), max_depth, max_breadth, limit, +4 more.
tavily-searchB
A powerful web search tool that provides comprehensive, real-time results using Tavily's AI search engine. Returns relevant web content with customizable parameters for result count, content type, and domain filtering. Ideal for gathering current information, news, and detailed web content analysis.
Inputs: query (required), search_depth, topic, days, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: crawling (tavily-crawl) focuses on structured exploration from a base URL, extraction (tavily-extract) retrieves raw content from specific URLs, mapping (tavily-map) analyzes site structure, and search (tavily-search) provides real-time web results. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent 'tavily-' prefix with a descriptive action suffix (crawl, extract, map, search), using a uniform hyphenated style. This predictable pattern enhances readability and reduces confusion, with no deviations in naming conventions.
With 4 tools, the server is well-scoped for its web-related domain, covering key operations like crawling, extraction, mapping, and search without bloat. Each tool earns its place by addressing a distinct aspect of web interaction, making the count appropriate and manageable.
The tool set provides complete coverage for web-based tasks, including discovery (crawl, map), content retrieval (extract, search), and analysis. There are no obvious gaps; agents can perform end-to-end workflows from finding sites to extracting and analyzing content without dead ends.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It enables users to analyze public market data (SEC filings, earnings transcripts, financial metrics, and stock data for 8000+ companies), private market data (3M+ companies, 500k+ funding rounds, 2M+ M&A/IPO transactions), and conduct deep research including web scraping capabilities. The server also features autonomous research agents that search hundreds of sources and return fully cited reports in approximately one minute.
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis server allows users to perform web searches using Perplexity AI, providing a tool for retrieving search results through a simple API interface.13ISC
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with real-time web search, intelligent data extraction from web pages, website mapping, and web crawling capabilities through Tavily's API. Enables comprehensive web research and content analysis through natural language interactions.MIT
- AlicenseBqualityDmaintenanceProvides AI assistants with real-time web search capabilities and intelligent data extraction from web pages through Tavily's advanced search API.221,321 npmMIT
- AlicenseAqualityDmaintenanceProvides AI assistants with real-time web search capabilities, intelligent data extraction from web pages, website mapping, and web crawling through Tavily's API.4MIT
