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 的高级搜索和数据提取功能无缝集成。这种集成为 AI 模型提供对网络信息的实时访问，并提供复杂的过滤选项和特定领域的搜索功能。

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 运行

npx -y tavily-mcp@0.1.4  

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Tavily MCP Server：

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：

   # 使用 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：

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

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

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

   {
     "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. 导航到 Features > MCP Servers
3. 单击“+ Add New MCP Server”按钮
4. 填写以下信息：
   • Name: 输入服务器的昵称（例如，“tavily-mcp”）
   • Type: 选择“command”作为类型
   • Command: 输入运行服务器的命令：

     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 服务器右上角的刷新按钮来填充工具列表。

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

配置 Claude Desktop 应用程序 🖥️

对于 macOS：

# 如果配置文件不存在，则创建它
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：

code %APPDATA%\Claude\claude_desktop_config.json

添加 Tavily 服务器配置：

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

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

2. Git 安装

1. 克隆存储库：

git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置 Claude Desktop 应用程序 ⚙️

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

将 your-api-key-here 替换为您的实际 Tavily API 密钥，并将 /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. 通用网络搜索：

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

2. 新闻搜索：

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

3. 特定领域的搜索：

在 nature.com 和 sciencedirect.com 上搜索有关气候变化的研究

Tavily 提取示例

1. 提取文章内容：

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

✨ 结合搜索和提取 ✨

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

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

故障排除 🛠️

常见问题

1. 找不到服务器

   • 通过运行 npm --verison 验证 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"。

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

致谢 ✨

• 模型上下文协议 用于 MCP 规范
• Anthropic 用于 Claude Desktop