mcp-tavily-search

⚠️お知らせ

このリポジトリはメンテナンスされなくなりました。

このツールの機能は、複数の MCP ツールを 1 つの統合パッケージにまとめたmcp-omnisearchで利用できるようになりました。

代わりにmcp-omnisearchを使用してください。

Tavilyの検索APIをLLMに統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、RAGアプリケーション向けのコンテキスト生成や直接的な質問応答など、高品質で事実に基づいた結果を提供するように最適化されたインテリジェントなWeb検索機能を提供します。

特徴

• 🔍 Tavily API による高度なウェブ検索機能

• 🤖 AIが生成した検索結果の要約

• 🎯 ドメインフィルタリングでより高品質な結果を表示

• 📊 検索の深さとパラメータを設定可能

• 🧠 RAG アプリケーションのコンテキスト生成

• ❓ 直接的な質問回答機能

• 💾 TTLサポートによるレスポンスキャッシュ

• 📝 複数のレスポンス形式（テキスト、JSON、マークダウン）

• 🔄 LLM向けに最適化された構造化された結果フォーマット

• 🏗️ モデルコンテキストプロトコルに基づいて構築

構成

このサーバーはMCPクライアント経由で設定する必要があります。以下に、様々な環境における設定例を示します。

傾斜構成

Cline MCP 設定に以下を追加します:

WSL 構成の Claude デスクトップ

WSL 環境の場合は、Claude Desktop 構成に以下を追加します。

環境変数

サーバーには次の環境変数が必要です。

• TAVILY_API_KEY : Tavily APIキー（必須）

API

サーバーは、構成可能なパラメータを持つ 3 つの MCP ツールを実装します。

タビリー検索

高品質で事実に基づいた結果を得るように最適化された Tavily Search API を使用して Web を検索します。

パラメータ:

• query （文字列、必須）: 検索クエリ

• search_depth （文字列、オプション）: 「basic」（高速）または「advanced」（より徹底的）。デフォルトは「basic」

• topic （文字列、オプション）: "general" または "news"。デフォルトは "general"

• days （数値、オプション）：検索から遡る日数（ニューストピックのみ）。デフォルトは3

• time_range (文字列、オプション): 結果の時間範囲 ('day'、'week'、'month'、'year' または 'd'、'w'、'm'、'y')

• max_results (数値、オプション): 結果の最大数。デフォルトは5

• include_answer （ブール値、オプション）：AI生成の要約を含める。デフォルトはtrue

• include_images (ブール値、オプション): 関連画像を含める。デフォルトはfalse

• include_image_descriptions (ブール値、オプション): 画像の説明を含める。デフォルトはfalse

• include_raw_content (ブール値、オプション): 生のHTMLコンテンツを含める。デフォルトはfalse

• include_domains (文字列[], オプション): 含める信頼されたドメインのリスト

• exclude_domains (文字列[], オプション): 除外するドメインのリスト

• response_format （文字列、オプション）: 'text'、'json'、または'markdown'。デフォルトは'text'

• cache_ttl (数値、オプション): キャッシュの有効期間（秒）。デフォルトは3600

• force_refresh （ブール値、オプション）：キャッシュを無視して最新の結果を強制的に表示します。デフォルトはfalseです。

tavily_get_search_context

Tavily 検索を使用して RAG アプリケーションのコンテキストを生成します。

パラメータ:

• query (文字列、必須): コンテキスト生成のための検索クエリ

• max_tokens (数値、オプション): 生成されるコンテキストの最大長。デフォルトは2000

• search_depth （文字列、オプション）：「basic」または「advanced」。デフォルトは「advanced」

• topic （文字列、オプション）: "general" または "news"。デフォルトは "general"

• その他のパラメータはtavily_searchと同じ

tavily_qna_search

Tavily 検索を使用して質問への直接的な回答を取得します。

パラメータ:

• query （文字列、必須）: 回答したい質問

• include_sources (boolean, オプション): ソースの引用を含める。デフォルトはtrue

• search_depth （文字列、オプション）：「basic」または「advanced」。デフォルトは「advanced」

• topic （文字列、オプション）: "general" または "news"。デフォルトは "general"

• その他のパラメータはtavily_searchと同じ

ドメインフィルタリング

サーバーは、次の 2 つのオプション パラメータを通じて柔軟なドメイン フィルタリングをサポートします。

• include_domains : 検索結果に含める信頼できるドメインの配列

• exclude_domains : 検索結果から除外するドメインの配列

これにより、次のことが可能になります。

• 学術的または技術的な検索のために特定の信頼できるソースをターゲットにする

• 信頼性が低い、または関連性のない可能性のある情報源を除外する

• 特定のニーズに基づいてソースをカスタマイズする

• フィルタリングが指定されていない場合は、利用可能なすべてのソースにアクセスします

ドメインフィルタリングの例:

発達

設定

1. リポジトリをクローンする

2. 依存関係をインストールします:

3. プロジェクトをビルドします。

4. 開発モードで実行:

出版

このプロジェクトではバージョン管理に変更セットを使用しています。公開するには：

1. 変更セットを作成します。

2. パッケージのバージョン:

3. npm に公開:

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。

謝辞

• モデルコンテキストプロトコルに基づいて構築

• Tavily Search APIを搭載