Tavily MCP Sse

🚀 Tavily MCP サーバー

FastAPI をベースにした基本的なサーバーアプリケーションで、Tavily API とのやり取りを行うエンドポイントを提供します。このサーバーには API キーによる認証機能が備わっており、fastapi-mcp ライブラリを使用してリモート SSE MCP サーバーに変換されます。

🚀 クイックスタート

このサーバーは、Tavily API とのやり取りを容易にするために設計されています。以下の手順に従って、サーバーをセットアップして実行できます。

📦 インストール

プロジェクトの依存関係をインストールするには、以下のコマンドを実行してください。

pip install -r requirements.txt

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを使用します。

uvicorn server:app --host 0.0.0.0 --port 8000 --reload

サーバーは http://127.0.0.1:8000 で利用可能になります。

高度な使用法

サーバーを起動する前に、2 つの API キーを環境変数として設定する必要があります。

• API_KEY：サーバーのエンドポイントにアクセスするためのキーです。
• TAVILY_API_KEY：Tavily API にアクセスするためのキーです。

📚 ドキュメント

エンドポイント

/tavily-search

Tavily API を使用して検索を実行します。

• メソッド：POST
• リクエストボディ：TavilySearchRequest
  • query (str)：検索クエリです。
  • search_depth (Literal["basic", "advanced"], オプション)：検索の深さです。デフォルトは "basic" です。
  • topic (Literal["general", "news"], オプション)：検索のトピックです。デフォルトは "general" です。
  • days (int, オプション)：検索する日数です。デフォルトは 3 です。
  • time_range (Literal["day", "week", "month", "year", "d", "w", "m", "y"], オプション)：検索の時間範囲です。デフォルトは "day" です。
  • max_results (int, オプション)：返す最大結果数です。デフォルトは 10 です。
  • include_images (bool, オプション)：結果に画像を含めるかどうかです。デフォルトは False です。
  • include_image_descriptions (bool, オプション)：結果に画像の説明を含めるかどうかです。デフォルトは False です。
  • include_raw_content (bool, オプション)：結果に生のコンテンツを含めるかどうかです。デフォルトは False です。
  • include_domains (list[str], オプション)：検索に含めるドメイン名のリストです。デフォルトは空のリストです。
  • exclude_domains (list[str], オプション)：検索から除外するドメイン名のリストです。デフォルトは空のリストです。
• レスポンス：TavilyResponse

/tavily-extract

Tavily API を使用して URL からコンテンツを抽出します。

• メソッド：POST
• リクエストボディ：TavilyExtractRequest
  • urls (list[str])：コンテンツを抽出する URL のリストです。
  • extract_depth (Literal["basic", "advanced"], オプション)：抽出の深さです。デフォルトは "basic" です。
  • include_images (bool, オプション)：抽出に画像を含めるかどうかです。デフォルトは False です。
• レスポンス：TavilyResponse