MCP Tavily Web Search Server

🚀 網絡搜索 MCP 服務器

本項目是一個基於 Tavily API 構建的 Model Context Protocol (MCP) 服務器，它提供了強大的網絡搜索工具。藉助該服務器，AI 模型能夠輕鬆訪問互聯網，獲取最新、最準確的信息，極大地拓展了 AI 模型的信息獲取能力。

🚀 快速開始

該 MCP 服務器實現了一個名為 search_web_tool 的工具，它利用 Tavily API 進行網絡搜索，並返回相關搜索結果。服務器就像一座橋樑，連接著 AI 模型和 Tavily 搜索引擎，讓模型在對話過程中能夠即時訪問互聯網信息。

✨ 主要特性

• 即時網絡搜索功能：能夠即時獲取最新的互聯網信息。
• 可自定義的搜索參數：
  • 搜索主題：支持通用、新聞、金融等多種主題搜索。
  • 搜索深度：提供基礎和高級兩種搜索深度選項。
  • 最大結果數：可根據需求設置返回的最大結果數量。
  • 時間範圍過濾：支持按天、周、月、年進行時間範圍過濾。
  • 域包含/排除：可以指定包含或排除某些特定的搜索域。

📦 安裝指南

環境要求

• Python 3.13+
• uv - Python 包安裝程序和解析器
• Tavily API 密鑰（需在 tavily.com 註冊獲取）

安裝步驟

1. 克隆倉庫（如有必要）。
2. 使用 uv 創建虛擬環境（可選但推薦）：

   uv venv
   激活：source .venv/bin/activate  # Windows 上：.venv\Scripts\activate
   

3. 使用 uv 安裝依賴項：

   uv pip 同步
   

🛠️ 配置說明

1. 複製提供的模板創建 .env 文件：

   cp env-sample .env
   

2. 將你的 Tavily API 密鑰添加到 .env 文件中：

   TAVILY_API_KEY=your-api-key-here
   

💻 使用示例

啟動服務器

使用 uv 運行服務器：

uv 運行 web_search_server.py

該服務器使用 stdio 傳輸方法進行 MCP 通信，適合與支持模型上下文協議的各種 AI 系統集成。

工具參數

search_web_tool 接受以下參數：

📚 詳細文檔

響應格式

工具返回一個搜索結果列表，每個結果包含以下信息：

• title：搜索結果標題
• url：搜索結果 URL
• content：搜索結果內容
• score：搜索結果的相關性評分

錯誤處理

如果在搜索操作期間發生錯誤，工具將返回描述問題的錯誤消息。