Web Search

🚀 Cardea Web Search MCP Server

Cardea Web Search MCP Serverは、Cardeaプロジェクトのコンポーネントで、Multi-Channel Protocol (MCP) サーバを通じてウェブ検索機能を提供します。Tavily APIを利用してウェブ検索結果を取得し、返します。

✨ 主な機能

🔍 検索ツール

• search
  • 与えられたクエリに対するウェブ検索を実行します。
  • 入力パラメータ:
    • query: 検索するクエリ
  • 出力パラメータ:
    • query: 元のクエリ
    • response_time: レスポンスを取得するのにかかった時間
    • results: 検索結果のリストで、各結果には以下が含まれます。
      • content: 検索結果の主要な内容
      • raw_content: 検索結果の生の内容
      • score: 検索結果の関連性スコア
      • title: 検索結果のタイトル
      • url: 検索結果のURL

📦 インストール

ビルド

# build mcp server
cargo build --release

💻 使用例

サーバの起動前の準備

⚠️ 重要提示

MCPサーバを起動する前に、Tavily APIキーを設定する必要があります。キーはこちらから取得できます。

export TAVILY_API_KEY=<your-api-key>

MCPサーバのコマンドラインオプション

Usage: cardea-web-search [OPTIONS]

Options:
  -s, --socket-addr <SOCKET_ADDR>  Socket address to bind to [default: 127.0.0.1:8010]
  -t, --transport <TRANSPORT>      Transport type to use (sse or stream-http) [default: stream-http] [possible values: sse, stream-http]
  -m, --max-results <MAX_RESULTS>  Max results to return [default: 5]
  -h, --help                       Print help
  -V, --version                    Print version

サーバの起動

# run mcp server (stream-http)
./target/release/cardea-web-search --transport stream-http

# run mcp server (sse)
./target/release/cardea-web-search --transport sse

起動成功時の出力

サーバが正常に起動すると、以下の出力が表示されます。

Starting Cardea Web Search MCP server on 127.0.0.1:8010