Tavily MCP 服务器 🚀

🔌 兼容 Cline, Cursor, Claude Desktop 以及其他任何 MCP 客户端！

Tavily MCP 也与任何 MCP 客户端兼容

📚 结合 Tavily MCP 和 Neo4j MCP 服务器的教程!

📚 在 VS Code 中将 Tavily MCP 与 Cline 集成的教程 (演示 + 示例用例)

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

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

Tavily MCP 服务器提供：

• 与 tavily-search 和 tavily-extract 工具的无缝交互
• 通过 tavily-search 工具实现的实时网络搜索能力
• 通过 tavily-extract 工具从网页中智能提取数据

先决条件 🔧

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

• Tavily API 密钥
  • 如果您还没有 Tavily API 密钥，可以在此处注册免费帐户
• 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 for Windows

Tavily MCP 服务器安装 ⚡

使用 NPX 运行

bash
npx -y tavily-mcp@0.1.4

通过 Smithery 安装

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

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

虽然您可以单独启动一个服务器，但这在孤立情况下并不是特别有用。相反，您应该将其集成到 MCP 客户端中。下面是如何配置 Claude Desktop 应用程序以与 tavily-mcp 服务器配合工作的示例。

配置 MCP 客户端 ⚙️

本仓库将解释如何配置 Cursor 和 Claude Desktop 以与 tavily-mcp 服务器一起工作。

配置 Cline 🤖

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

1. 在 VS Code 中打开 Cline
2. 单击侧边栏中的 Cline 图标
3. 导航到 "MCP Servers" 标签（4个方块图标）
4. 搜索 "Tavily" 并点击 "install"
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%CodeUserglobalStoragesaoudrizwan.claude-devsettingscline_mcp_settings.json

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

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

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

3. 保存文件，如果 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"）

   • 类型：选择 "命令" 作为类型

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

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

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

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

配置 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%Claudeclaude_desktop_config.json

添加 Tavily 服务器配置：

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

json
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@0.1.2"],
"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 桌面配置语法
   • 通过运行 node --version 确保 Node.js 正确安装

2. NPX 相关问题

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

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

致谢 ✨

• Model Context Protocol 提供了 MCP 规范
• Anthropic 提供了 Claude 桌面应用