MCP Tavily Web Search Server

🚀 ネットワーク検索 MCP サーバー

Tavily API を使用して実装された Model Context Protocol (MCP) サーバーで、ネットワーク検索ツールを提供します。このサーバーにより、AI モデルがインターネットにアクセスし、最新の情報を取得できるようになります。

🚀 クイックスタート

この MCP サーバーは、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. .env ファイルにあなたの Tavily API キーを追加します:

   TAVILY_API_KEY=your-api-key-here
   

使用方法

uv を使用してサーバーを起動します:

uv 実行 web_search_server.py

このサーバーは、stdio 転送方法を使用して MCP 通信を行い、モデルコンテキストプロトコルをサポートするさまざまな AI システムとの統合に適しています。

ツールパラメータ

search_web_tool は以下のパラメータを受け取ります:

• query (str, 必須): 検索クエリ。
• search_topic (str, オプション): 検索トピック。"general"、"news"、または "finance" のいずれかで、デフォルトは "general"。
• search_depth (str, オプション): 検索深度。"basic" または "advanced" のいずれかで、デフォルトは "basic"。
• max_results (int, オプション): 返される最大結果数。デフォルトは 1。
• time_range (str, オプション): 検索の時間範囲。"day"、"week"、"month"、または "year" のいずれかで、デフォルトは None。
• include_domains (list[str], オプション): 検索に含めるドメインのリスト。
• exclude_domains (list[str], オプション): 検索から除外するドメインのリスト。

応答形式

ツールは検索結果のリストを返し、各結果には以下が含まれます:

• title: 検索結果のタイトル
• url: 検索結果の URL
• content: 検索結果の内容
• score: 検索結果の関連性スコア

エラー処理

検索操作中にエラーが発生した場合、ツールは問題を説明するエラーメッセージを返します。