模型上下文协议（MCP）是一个开放标准，它使AI系统能够与各种数据源和工具无缝交互，促进安全的双向连接。

由Anthropic开发的模型上下文协议（MCP）使像Claude这样的AI助手能够无缝集成Tavily的高级搜索和数据提取功能。这种集成提供了对网络信息的实时访问，并配备了复杂的过滤选项和特定领域的搜索特性。

Tavily MCP服务器提供：

• 搜索、提取、映射、爬取工具
• 通过tavily-search工具实现的实时网络搜索能力
• 通过tavily-extract工具从网页智能提取数据
• 强大的网络映射工具，可创建网站的结构化地图
• 系统地探索网站的网络爬虫

📚 有用的资源

• 教程：结合Tavily MCP与Neo4j MCP服务器
• 教程：在VS Code中集成Tavily MCP与Cline

准备工作 🔧

开始之前，请确保您已具备以下条件：

• Tavily API密钥
  • 如果您还没有Tavily API密钥，可以在这里注册免费账户
• Claude Desktop 或 Cursor
• Node.js (版本20或更高)
  • 您可以通过运行以下命令来验证您的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 for Windows

Tavily MCP服务器安装 ⚡

使用NPX运行

bash
npx -y tavily-mcp@latest

通过Smithery安装

要通过Smithery自动为Claude Desktop安装Tavily MCP服务器：

bash
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块添加到VS Code中的用户设置（JSON）文件中。您可以通过按 Ctrl + Shift + P（或macOS上的 Cmd + Shift + P）并键入 Preferences: Open User Settings (JSON) 来完成此操作。

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

可选地，您可以将其添加到工作区中的 .vscode/mcp.json 文件中：

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

配置Cline 🤖

在Cline中设置Tavily MCP服务器最简单的方法是通过市场单击安装：

1. 在VS Code中打开Cline
2. 点击侧边栏中的Cline图标
3. 导航到“MCP Servers”选项卡（4个方块）
4. 搜索“Tavily”并点击“安装”
5. 提示时输入您的Tavily API密钥

或者，您可以手动在Cline中设置Tavily MCP服务器：

1. 打开Cline MCP设置文件：

   对于macOS：

   bash

   使用Visual Studio Code

   code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   或者使用TextEdit

   open -e ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   对于Windows：

   bash
   code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

2. 将Tavily服务器配置添加到文件中：

   将 your-api-key-here 替换为您的实际Tavily API密钥。

   json
   {
   "mcpServers": {
   "tavily-mcp": {
   "command": "npx",
   "args": ["-y", "tavily-mcp@latest"],
   "env": {
   "TAVILY_API_KEY": "your-api-key-here"
   },
   "disabled": false,
   "autoApprove": []
   }
   }
   }

3. 保存文件，如果Cline已经在运行，则重启Cline。

4. 使用Cline时，您现在可以访问Tavily MCP工具。您可以在对话中直接要求Cline使用tavily-search和tavily-extract工具。

配置Cursor 🖥️

注意：需要Cursor版本0.45.6或更高版本要在 Cursor 中设置 Tavily MCP 服务器：

1. 打开 Cursor 设置
2. 导航到 功能 > MCP 服务器
3. 点击 "+ 添加新 MCP 服务器" 按钮
4. 填写以下信息：

   • 名称：输入服务器的昵称（例如："tavily-mcp"）

   • 类型：选择 "command" 作为类型

   • 命令：输入运行服务器的命令：
     bash
     env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@latest

     重要：将 your-api-key 替换为您的 Tavily API 密钥。您可以在 app.tavily.com/home 获取。

添加服务器后，它应该会出现在 MCP 服务器列表中。您可能需要手动点击 MCP 服务器右上角的刷新按钮来填充工具列表。

Composer Agent 将在与您的查询相关时自动使用 Tavily MCP 工具。最好通过描述您想做的事情来明确请求使用这些工具（例如：“使用 tavily-search 搜索有关 AI 的最新新闻”）。在 Mac 上按 command + L 打开聊天，选择屏幕顶部的 composer 选项，在提交按钮旁边选择代理，并在准备就绪时提交查询。

配置 Claude 桌面应用程序 🖥️

对于 macOS：

bash

如果配置文件不存在，则创建

touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

在 TextEdit 中打开配置文件

open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

使用 Visual Studio Code 的替代方法（需要安装 VS Code）

code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

对于 Windows：

bash
code %APPDATA%\Claude\claude_desktop_config.json

添加 Tavily 服务器配置：

将 your-api-key-here 替换为您的实际 Tavily API 密钥。

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

2. Git 安装

1. 克隆仓库：
   bash
   git clone https://github.com/tavily-ai/tavily-mcp.git
   cd tavily-mcp

2. 安装依赖项：
   bash
   npm install

3. 构建项目：
   bash
   npm run build

配置 Claude 桌面应用程序 ⚙️

按照上面 配置 Claude 桌面应用程序 部分概述的配置步骤，使用下面的 JSON 配置。

将 your-api-key-here 替换为您的实际 Tavily API 密钥，并将 /path/to/tavily-mcp 替换为您系统中克隆仓库的实际路径。

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

在 Claude 桌面应用程序中的使用 🎯

安装完成后并配置好 Claude 桌面应用程序后，您必须完全关闭并重新打开 Claude 桌面应用程序才能看到 tavily-mcp 服务器。您应该会在应用程序左下角看到一个锤子图标，表示可用的 MCP 工具，您可以点击锤子图标以查看有关 tavily-search 和 tavily-extract 工具的更多详细信息。

现在 Claude 将能够完全访问 tavily-mcp 服务器，包括 tavily-search 和 tavily-extract 工具。如果您将以下示例插入 Claude 桌面应用程序，您应该可以看到 tavily-mcp 服务器工具的效果。

Tavily 搜索示例

1. 通用网络搜索：

你能搜索一下量子计算的最新进展吗？

1. 新闻搜索：

搜索过去7天内关于 AI 初创公司的新闻文章。

1. 特定领域搜索：

在 nature.com 和 sciencedirect.com 上搜索气候变化研究### Tavily 提取示例

1. 提取文章内容:

从这篇文章中提取主要内容: https://example.com/article

✨ 结合搜索与提取 ✨

您还可以结合使用 tavily-search 和 tavily-extract 工具来执行更复杂的任务。

搜索过去7天内关于AI初创企业的新闻文章，并从每篇文章中提取主要内容以生成详细的报告。

故障排除 🛠️

常见问题

1. 找不到服务器

   • 通过运行 npm --version 验证 npm 安装情况
   • 通过运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json 检查 Claude Desktop 配置语法
   • 通过运行 node --version 确保 Node.js 正确安装

2. NPX 相关问题

• 如果遇到与 npx 相关的错误，可能需要使用 npx 可执行文件的完整路径。
• 可以通过在终端中运行 which npx 找到该路径，然后将配置中的 "command": "npx" 行替换为 "command": "/full/path/to/npx"。

1. API 密钥问题
   • 确认您的 Tavily API 密钥有效
   • 检查 API 密钥是否已在配置中正确设置
   • 确认 API 密钥周围没有空格或引号

致谢 ✨

• 模型上下文协议 提供了 MCP 规范
• Anthropic 提供了 Claude Desktop