Tavily MCP Server

Tavily MCP Server

Tavily API と連携するためのエンドポイントを提供する、FastAPI ベースの基本的なサーバーアプリケーションです。API キー認証を備えており、fastapi-mcp ライブラリを使用して、リモート SSE MCP サーバーを作成します。

インストール

プロジェクトの依存関係をインストールするには、次のコマンドを実行します。

pip install -r requirements.txt

使い方

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

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

サーバーは http://127.0.0.1:8000 で利用できます。

API キー

このサーバーでは、2 つの API キーが必要です。

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

サーバーを起動する前に、これらの API キーを環境変数として設定してください。

エンドポイント

/tavily-search

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

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

/tavily-extract

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

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