Tavily MCP

🚀 [Tavily MCP - 模型上下文协议服务器]

模型上下文协议（MCP）是一个开放标准，它能让AI系统与各种数据源和工具进行无缝交互，实现安全的双向连接。Tavily MCP服务器集成了先进搜索和数据提取功能，为AI模型提供实时网页信息访问。

🎉 v0.2.1版本引入 tavily-crawl + tavily-map！ 🎉

模型上下文协议（MCP）由Anthropic开发，它使Claude等AI助手能够与Tavily的高级搜索和数据提取功能无缝集成。这种集成让AI模型能够实时访问网页信息，还具备复杂的过滤选项和特定领域的搜索功能。

Tavily MCP服务器提供以下功能：

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

📚 实用资源

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

🔧 先决条件

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

• Tavily API密钥
  • 如果您没有Tavily API密钥，可以在此注册免费账户
• Claude桌面版 或 Cursor
• Node.js（v20或更高版本）
  • 您可以通过运行 node --version 来验证Node.js的安装情况
• 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.2.1  

通过Smithery安装

要通过 Smithery 自动为Claude桌面版安装Tavily MCP服务器，请运行以下命令：

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

虽然您可以单独启动服务器，但孤立运行的作用不大。相反，您应该将其集成到MCP客户端中。以下是如何配置Claude桌面应用程序以与tavily-mcp服务器配合使用的示例。

⚙️ 配置MCP客户端

本仓库将介绍如何配置 VS Code、Cursor 和 Claude桌面版 以与tavily-mcp服务器配合使用。

💻 配置VS Code

要一键安装，请点击以下安装按钮之一：

手动安装

首先检查本节顶部是否有符合您需求的安装按钮。如果您更喜欢手动安装，请按照以下步骤操作：

将以下JSON块添加到VS Code的用户设置（JSON）文件中。您可以通过按 Ctrl + Shift + P（在macOS上按 Cmd + Shift + P）并输入 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

在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.2.1"],
         "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 tavily-mcp@0.2.1
     

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

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

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

🖥️ 配置Claude桌面应用程序

对于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.2.1"],
      "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桌面应用程序

按照上述 配置Claude桌面应用程序 部分中概述的配置步骤进行操作，并使用以下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桌面应用程序中使用

安装完成且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 --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"。

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

✨ 致谢

• 模型上下文协议 提供MCP规范
• Anthropic 开发Claude桌面版