Web Search

🚀 Cardea Web Search MCP Server

Cardea Web Search MCP Server 是 Cardea 項目的一個組件，它通過多通道協議（MCP）服務器提供網頁搜索功能。該服務器藉助 Tavily API 來獲取並返回網頁搜索結果。

🚀 快速開始

✨ 主要特性

• 搜索功能：可針對給定的查詢進行網頁搜索。
• 詳細輸出：返回搜索結果的詳細信息，包括內容、原始內容、相關性得分、標題和 URL 等。

📦 安裝指南

# 構建 MCP 服務器
cargo build --release

💻 使用示例

基礎用法

在運行 MCP 服務器之前，你需要設置 Tavily API 密鑰。你可以從 Tavily 獲取密鑰。

export TAVILY_API_KEY=<your-api-key>

MCP 服務器的命令行選項如下：

Usage: cardea-web-search [OPTIONS]

Options:
  -s, --socket-addr <SOCKET_ADDR>  要綁定的套接字地址 [默認值: 127.0.0.1:8010]
  -t, --transport <TRANSPORT>      要使用的傳輸類型 (sse 或 stream-http) [默認值: stream-http] [可能的值: sse, stream-http]
  -m, --max-results <MAX_RESULTS>  要返回的最大結果數 [默認值: 5]
  -h, --help                       打印幫助信息
  -V, --version                    打印版本信息

現在，讓我們通過運行以下命令來啟動 MCP 服務器：

# 以 stream-http 方式運行 MCP 服務器
./target/release/cardea-web-search --transport stream-http

# 以 sse 方式運行 MCP 服務器
./target/release/cardea-web-search --transport sse

如果成功啟動，你將看到以下輸出：

Starting Cardea Web Search MCP Server on 127.0.0.1:8010

📚 詳細文檔

工具介紹

• search
  • 功能：針對給定的查詢進行網頁搜索。
  • 輸入參數：
    • query：要搜索的查詢內容。
  • 輸出參數：
    • query：原始查詢內容。
    • response_time：獲取響應所花費的時間。
    • results：搜索結果列表，每個結果包含：
      • content：搜索結果的主要內容。
      • raw_content：搜索結果的原始內容。
      • score：搜索結果的相關性得分。
      • title：搜索結果的標題。
      • url：搜索結果的 URL。

🔧 技術細節

該服務器藉助 Tavily API 來獲取網頁搜索結果，通過多通道協議（MCP）為用戶提供搜索服務。在運行服務器之前，需要設置 Tavily API 密鑰，以確保能夠正常訪問 Tavily 的搜索服務。服務器支持兩種傳輸類型：sse 和 stream-http，用戶可以根據需求進行選擇。同時，還可以通過命令行選項設置服務器的綁定地址和返回的最大結果數。

📄 許可證

文檔中未提及相關許可證信息。