tavily-mcp

Tavily MCP 服务 🚀

🔌 兼容 Cline、Cursor、Claude Desktop 和任何其他 MCP 客户端！

Tavily MCP 也兼容任何 MCP 客户端

📚 关于将 Tavily MCP 与 Neo4j MCP 服务结合使用的教程！

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

模型上下文协议（MCP）是一种开放标准，可让 AI 系统与各种数据源和工具无缝交互，并建立安全的双向连接。

模型上下文协议（MCP）由 Anthropic 开发，可让 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 [email protected]  

通过 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：

   # 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
   

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

   将 your-api-key-here 替换为你自己的 Tavily API 密钥。

   {
     "mcpServers": {
       "tavily-mcp": {
         "command": "npx",
         "args": ["-y", "[email protected]"],
         "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. 填写以下信息：
   • 名称：输入服务的昵称（例如，“tavily-mcp”）
   • 类型：选择“command”作为类型
   • 命令：输入运行服务的命令：

     env TAVILY_API_KEY=your-api-key npx -y [email protected]
     

     重要：将 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：

# 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 替换为你实际的 Tavily API 密钥。

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "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 Search 示例

1. 常规网络搜索：

Can you search for recent developments in quantum computing?

2. 新闻搜索：

Search for news articles about AI startups from the last 7 days.

3. 特定域名搜索：

Search for climate change research on nature.com and sciencedirect.com

Tavily Extract 示例

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 --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 密钥前后没有空格或引号

致谢 ✨

• Model Context Protocol 提供 MCP 规范
• Anthropic 提供 Claude Desktop