Tavily

官方

官方 Tavily MCP 伺服器，用於 AI 搜尋與內容擷取，為 MCP 客戶端提供網頁搜尋、爬取與擷取工具。

GitHub

2.2k

你可以用 Tavily MCP 做什麼？

即時搜尋網路 — 使用 tavily-search 查詢最新資訊、新聞或解答。
從網址提取結構化內容 — 透過 tavily-extract 從特定網頁擷取乾淨且相關的資料。
繪製網站結構 — 經由 tavily-map 取得某個網域下頁面與區塊的概覽。
系統化爬取網站 — 利用 tavily-crawl 從起始網址探索多個連結頁面。

文件

Tavily MCP 伺服器

npm

Tavily MCP 伺服器提供：

搜尋、提取、地圖、爬取工具
透過 tavily-search 工具提供即時網頁搜尋功能
透過 tavily-extract 工具從網頁中智慧提取資料
強大的網頁地圖工具，可建立網站的結構化地圖
系統性探索網站的網頁爬蟲

📚 實用資源

教學：將 Tavily MCP 與 Neo4j MCP 伺服器結合使用
教學：在 VS Code 中將 Tavily MCP 與 Cline 整合

遠端 MCP 伺服器

直接連線到 Tavily 的遠端 MCP 伺服器，無需在本機執行。這提供了無縫體驗，無需本機安裝或設定。

只需使用遠端 MCP 伺服器 URL 和您的 Tavily API 金鑰：

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

從 tavily.com 取得您的 Tavily API 金鑰。

或者，如果 MCP 客戶端支援，您可以透過 Authorization 標頭傳遞 API 金鑰：

Authorization: Bearer <your-api-key>

注意： 使用遠端 MCP 時，您可以透過包含一個 DEFAULT_PARAMETERS 標頭來為所有請求指定預設參數，該標頭包含一個帶有您所需預設值的 JSON 物件。範例：

{"include_images":true, "search_depth": "basic", "max_results": 10}

連線到 Claude Code

Claude Code 是 Anthropic 為 Claude 提供的官方 CLI 工具。您可以使用 claude mcp add 指令新增 Tavily MCP 伺服器。有兩種驗證方式：

選項 1：在 URL 中使用 API 金鑰

直接在 URL 中傳遞您的 API 金鑰。將 <your-api-key> 替換為您實際的 Tavily API 金鑰：

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

選項 2：OAuth 驗證流程

在 URL 中不帶 API 金鑰新增伺服器：

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

新增後，您需要完成驗證流程：

執行 claude 來啟動 Claude Code
輸入 /mcp 來開啟 MCP 伺服器管理
選取 Tavily 伺服器並完成驗證程序

提示： 在任何一個指令中加入 --scope user，即可讓 Tavily MCP 伺服器在所有專案中全域可用：

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

設定完成後，您將可以使用 Tavily 的搜尋、提取、地圖和爬取工具。

連線到 Cursor

點擊 ⬆️ 新增到 Cursor ⬆️ 按鈕，這將為您完成大部分工作，但您仍需要編輯設定以新增您的 API 金鑰。您可以在此取得 Tavily API 金鑰。

點擊按鈕後，您應該會被重新導向到 Cursor ...

步驟 1

點擊安裝按鈕

步驟 2

您應該會看到 MCP 現已安裝，如果藍色滑桿尚未開啟，請手動將其開啟。您還需要編輯設定以包含您自己的 Tavily API 金鑰。

步驟 3

然後您將被重新導向到您的 mcp.json 檔案，您必須在其中新增 your-api-key。

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

遠端 MCP 伺服器 OAuth 流程

Tavily 遠端 MCP 伺服器支援安全的 OAuth 驗證，讓您可以與相容的客戶端無縫連線和授權。

如何設定 OAuth 驗證

A. 使用 MCP Inspector：

開啟 MCP Inspector 並點擊「Open Auth Settings」。
選取 OAuth 流程並完成以下步驟：
1. 中繼資料探索
2. 客戶端註冊
3. 準備授權
4. 請求授權並取得授權碼
5. 權杖請求
6. 驗證完成

完成後，您將收到一個存取權杖，讓您可以安全地向 Tavily 遠端 MCP 伺服器發出已驗證的請求。

B. 使用其他 MCP 客戶端（範例：Cursor）：

您可以設定 MCP 客戶端使用 OAuth，而無需在 URL 中包含 Tavily API 金鑰。例如，在您的 mcp.json 中：

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

如果您需要清除已儲存的 OAuth 憑證並重新驗證，請執行：

rm -rf ~/.mcp-auth

注意：

OAuth 驗證是選用的。您仍然可以隨時使用 API 金鑰驗證，方法是將 Tavily API 金鑰包含在 URL 查詢參數 (?tavilyApiKey=...) 中，或如上所述在 Authorization 標頭中設定。

選取用於 OAuth 的 API 金鑰

成功完成 OAuth 驗證後，您可以透過將其命名為 mcp_auth_default 來控制使用哪個 API 金鑰：

如果您在個人帳戶中設定了一個名為 mcp_auth_default 的金鑰，則該金鑰將用於驗證流程。
如果您屬於某個團隊，且該團隊有一個名為 mcp_auth_default 的金鑰，則該金鑰將用於驗證流程。
如果您同時擁有個人金鑰和名為 mcp_auth_default 的團隊金鑰，則個人金鑰將被優先使用。
如果未設定 mcp_auth_default 金鑰，則將使用您個人帳戶中的 default 金鑰。如果未設定 default 金鑰，則將使用第一個可用的金鑰。

本機 MCP

先決條件 🔧

開始之前，請確保您擁有：

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

使用 NPX 執行

npx -y tavily-mcp@latest

預設參數設定 ⚙️

您可以使用 DEFAULT_PARAMETERS 環境變數為 tavily-search 工具設定預設參數值。這讓您可以設定預設的搜尋行為，而無需在每個請求中指定這些參數。

設定範例

export DEFAULT_PARAMETERS='{"include_images": true}'

客戶端使用範例

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

識別終端使用者（選用）

您可以選擇性地透過設定 TAVILY_HUMAN_ID 環境變數來識別代表其發出請求的終端使用者。設定後，Tavily MCP 會將其作為 X-Human-Id 標頭轉發到每個 API 呼叫，從而實現每個使用者的分析。

這是完全選用的 — 不設定它，行為保持不變。

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

隱私權注意事項： Tavily 在儲存之前會在伺服器端對 human_id 進行雜湊處理（SHA-256），因此原始值永遠不會被保留。即便如此，請盡可能使用不透明的識別碼（例如內部使用者 ID），而非原始 PII（如電子郵件）。

致謝 ✨

Model Context Protocol 提供 MCP 規範
Anthropic 提供 Claude Desktop