Tavily MCP

🚀 Tavily MCP

Model Context Protocol (MCP) 是一個開放標準，它能讓 AI 系統與各種數據源和工具進行無縫交互，實現安全的雙向連接。Tavily MCP 服務器集成了搜索、提取、映射和爬取等工具，為 AI 模型提供實時的網絡信息訪問能力。

🎉 版本 0.2.1 中引入了 tavily-crawl 和 tavily-map！🎉

🚀 快速開始

功能概述

由 Anthropic 開發的 Model Context Protocol (MCP) 允許像 Claude 這樣的 AI 助手與 Tavily 的高級搜索和數據提取功能無縫集成。這種集成使 AI 模型能夠實時訪問網絡信息，並具備複雜的過濾選項和特定領域的搜索功能。

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

• 搜索、提取、映射、爬取工具
• 通過 tavily-search 工具實現實時網絡搜索功能
• 通過 tavily-extract 工具從網頁中智能提取數據
• 強大的網頁映射工具，可創建網站的結構化地圖
• 系統地探索網站的網絡爬蟲

📚 有用的資源

• 教程：關於將 Tavily MCP 與 Neo4j MCP 服務器結合使用
• 教程：關於在 VS Code 中將 Tavily MCP 與 Cline 集成

📦 安裝指南

前提條件 🔧

在開始之前，請確保您具備以下條件：

• Tavily API 密鑰
  • 如果您沒有 Tavily API 密鑰，可以在此註冊免費賬戶
• Claude Desktop 或 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 Desktop 安裝 Tavily MCP 服務器，請運行以下命令：

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) 來完成此操作。

{
  "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 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.2.1"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      }
    }
  }
}

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 Desktop 應用程序後，您必須完全關閉並重新打開 Claude Desktop 應用程序才能看到 tavily-mcp 服務器。您應該會在應用程序左下角看到一個錘子圖標，這表示有可用的 MCP 工具，您可以點擊錘子圖標查看 tavily-search 和 tavily-extract 工具的更多詳細信息。

現在，Claude 將可以完全訪問 tavily-mcp 服務器，包括 tavily-search 和 tavily-extract 工具。如果您將以下示例插入到 Claude Desktop 應用程序中，您應該會看到 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 密鑰周圍沒有空格或引號

✨ 致謝

• Model Context Protocol 提供 MCP 規範
• Anthropic 開發了 Claude Desktop