Web Search MCP Server

Web Search MCP Server

Tavily API を使用したウェブ検索ツールを提供する Model Context Protocol（MCP）サーバーです。このサーバーにより、AI モデルはインターネットを検索し、最新情報を取得できます。

概要

この MCP サーバーは、次の単一のツールを実装しています。

• search_web_tool：Tavily API を使用してウェブを検索し、関連する検索結果を返します。

このサーバーは、AI モデルと Tavily 検索エンジンの橋渡し役として機能し、会話中にモデルがインターネットから最新情報にアクセスできるようにします。

特長

• リアルタイムのウェブ検索機能
• カスタマイズ可能な検索パラメーター：
  • 検索トピック（general、news、finance）
  • 検索の深さ（basic、advanced）
  • 結果の最大件数
  • 期間による絞り込み（day、week、month、year）
  • ドメインの包含／除外

要件

• Python 3.13+
• uv - Python パッケージのインストーラーおよびリゾルバー
• Tavily API キー（tavily.com で登録してください）

インストール

1. リポジトリをクローンします（該当する場合）

2. uv を使用して仮想環境をセットアップします（任意ですが、推奨します）：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. uv を使用して依存関係をインストールします：

   uv pip sync
   

設定

1. 用意されているテンプレートをコピーして .env ファイルを作成します：

   cp env-sample .env
   

2. Tavily API キーを .env ファイルに追加します：

   TAVILY_API_KEY=your-api-key-here
   

使用方法

uv を使用してサーバーを実行します：

uv run web_search_server.py

このサーバーは、MCP 通信に stdio トランスポート方式を使用して動作します。そのため、Model Context Protocol をサポートするさまざまな 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：検索結果の関連性スコア

エラー処理

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