Tavily MCP サーバー

Tavilyの検索APIを活用したAIベースのウェブ検索機能を提供するモデルコンテキストプロトコル（CMP）サーバー。このサーバーにより、LLMは高度なウェブ検索を実行し、質問への直接的な回答を得たり、AIによって抽出された関連コンテンツを含む最近のニュース記事を検索したりすることが可能になります。

特徴

利用可能なツール

tavily_web_search - AI を活用したコンテンツ抽出により包括的な Web 検索を実行します。
- query （文字列、必須）: 検索クエリ
- max_results (整数、オプション): 返される結果の最大数 (デフォルト: 5、最大: 20)
- search_depth （文字列、オプション）: 「basic」または「advanced」の検索深度（デフォルト: 「basic」）
- include_domains (リストまたは文字列、オプション): 結果に具体的に含めるドメインのリスト
- exclude_domains (リストまたは文字列、オプション): 結果から除外するドメインのリスト
tavily_answer_search - Web 検索を実行し、裏付けとなる証拠とともに直接的な回答を生成します。
- query （文字列、必須）: 検索クエリ
- max_results (整数、オプション): 返される結果の最大数 (デフォルト: 5、最大: 20)
- search_depth （文字列、オプション）: 「基本」または「詳細」の検索深度（デフォルト: 「詳細」）
- include_domains (リストまたは文字列、オプション): 結果に具体的に含めるドメインのリスト
- exclude_domains (リストまたは文字列、オプション): 結果から除外するドメインのリスト
tavily_news_search - 公開日で最近のニュース記事を検索します。
- query （文字列、必須）: 検索クエリ
- max_results (整数、オプション): 返される結果の最大数 (デフォルト: 5、最大: 20)
- days (整数、オプション): 検索までの日数 (デフォルト: 3)
- include_domains (リストまたは文字列、オプション): 結果に具体的に含めるドメインのリスト
- exclude_domains (リストまたは文字列、オプション): 結果から除外するドメインのリスト

プロンプト

サーバーは、各検索タイプに対してプロンプトテンプレートも提供します。

tavily_web_search - TavilyのAI搭載検索エンジンを使用してウェブを検索します
tavily_answer_search - ウェブを検索し、裏付けとなる証拠とともに AI が生成した回答を取得します
tavily_news_search - Tavilyのニュース検索で最近のニュース記事を検索

前提条件

Python 3.11以降
Tavily API キー ( Tavily の Web サイトから取得)
uv Python パッケージマネージャー (推奨)

インストール

オプション1: pipまたはuvを使用する

# With pip
pip install mcp-tavily

# Or with uv (recommended)
uv add mcp-tavily

次のような出力が表示されます。

Resolved packages: mcp-tavily, mcp, pydantic, python-dotenv, tavily-python [...]
Successfully installed mcp-tavily-0.1.4 mcp-1.0.0 [...]

オプション2: ソースから

# Clone the repository
git clone https://github.com/RamXX/mcp-tavily.git
cd mcp-tavily

# Create a virtual environment (optional but recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies and build
uv sync  # Or: pip install -r requirements.txt
uv build  # Or: pip install -e .

# To install with test dependencies:
uv sync --dev  # Or: pip install -r requirements-dev.txt

インストール中に、パッケージがビルドされ、依存関係とともにインストールされるのを確認できます。

構成

APIキーの設定

サーバーには Tavily API キーが必要です。これは次の 3 つの方法で提供できます。

プロジェクトディレクトリ内の.envファイルを通じて:
TAVILY_API_KEY=your_api_key_here
環境変数として:
export TAVILY_API_KEY=your_api_key_here
コマンドライン引数として:
python -m mcp_server_tavily --api-key=your_api_key_here

Claude.app 用に設定する

Claude 設定に追加:

"mcpServers": {
  "tavily": {
    "command": "python",
    "args": ["-m", "mcp_server_tavily"]
  },
  "env": {
    "TAVILY_API_KEY": "your_api_key_here"
  }
}

問題が発生した場合、Pythonインタープリターへのフルパスを指定する必要があるかもしれません。正確なパスを確認するには、 which pythonを実行してください。

使用例

通常のウェブ検索の場合:

Tell me about Anthropic's newly released MCP protocol

ドメインフィルタリングを使用してレポートを生成するには:

Tell me about redwood trees. Please use MLA format in markdown syntax and include the URLs in the citations. Exclude Wikipedia sources.

直接回答を得るために回答検索モードを使用するには:

I want a concrete answer backed by current web sources: What is the average lifespan of redwood trees?

ニュース検索:

Give me the top 10 AI-related news in the last 5 days

テスト

このプロジェクトには包括的なテストスイートが含まれています。テストを実行するには、以下の手順に従ってください。

テストの依存関係をインストールします。
source .venv/bin/activate # If using a virtual environment uv sync --dev # Or: pip install -r requirements-dev.txt
テストを実行します。
./tests/run_tests.sh

次のような出力が表示されます。

============================= test session starts ==============================
collected 27 items

tests/test_models.py ................. [ 62%]
tests/test_utils.py ..... [ 81%]
tests/test_integration.py ..... [100%]

---------- coverage: platform darwin, python 3.13.2-final-0 ----------
Name                                Stmts   Miss  Cover
-------------------------------------------------------
src/mcp_server_tavily/__init__.py      16      2    88%
src/mcp_server_tavily/__main__.py       2      2     0%
src/mcp_server_tavily/server.py       137     80    42%
-------------------------------------------------------
TOTAL                                 155     84    46%


============================== 27 passed in 0.40s ==============================

テストスイートには、データモデル、ユーティリティ関数、統合テスト、エラー処理、パラメータ検証のテストが含まれています。ドメインフィルターや様々な入力形式の処理を含め、すべてのAPI機能が正しく動作することを確認することに重点を置いています。

デバッグ

MCP インスペクタを使用してサーバーをデバッグできます。

# Using npx
npx @modelcontextprotocol/inspector python -m mcp_server_tavily

# For development
cd path/to/mcp-tavily
npx @modelcontextprotocol/inspector python -m mcp_server_tavily

貢献

mcp-tavily の改善に向けた貢献を歓迎します。ご協力いただける方法は次のとおりです:

リポジトリをフォークする
機能ブランチを作成する ( git checkout -b feature/amazing-feature )
変更を加える
テストを実行して合格することを確認する
変更をコミットします（ git commit -m 'Add amazing feature' ）
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

他の MCP サーバーと実装パターンの例については、https: //github.com/modelcontextprotocol/serversを参照してください。

ライセンス

mcp-tavilyはMITライセンスに基づきます。詳細はLICENSEファイルをご覧ください。

Tavily MCP Server