Tavily Mcp

Tavily MCP サーバー

Tavily MCP サーバーでは、次の機能を利用できます。

• 検索、抽出、マッピング、クロールのツール
• tavily-search ツールによるリアルタイムのウェブ検索機能
• tavily-extract ツールによるウェブページからのインテリジェントなデータ抽出
• ウェブサイトの構造化マップを作成する強力なウェブマッピングツール
• ウェブサイトを体系的に探索するウェブクローラー

📚 参考資料

• Tavily MCP と Neo4j MCP サーバーを組み合わせる方法についてのチュートリアル
• Tavily MCP を VS Code の Cline と統合する方法についてのチュートリアル

リモート MCP サーバー

ローカルで実行する代わりに、Tavily のリモート MCP サーバーに直接接続できます。ローカルへのインストールや設定が不要で、シームレスに利用できます。

Tavily API キーを使用して、リモート MCP サーバーの URL を指定してください。

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key> 

Tavily API キーは、tavily.com から取得してください。

また、MCP クライアントが対応している場合は、Authorization ヘッダーを使って API キーを渡すこともできます。

Authorization: Bearer <your-api-key>

**注記：**リモート MCP を使用する場合、必要なデフォルト値を含む JSON オブジェクトを DEFAULT_PARAMETERS ヘッダーに指定すると、すべてのリクエストに適用するデフォルトパラメーターを設定できます。例：

{"include_images":true, "search_depth": "basic", "max_results": 10}

Claude Code に接続する

Claude Code は、Claude 用の Anthropic 公式 CLI ツールです。claude mcp add コマンドを使用して、Tavily MCP サーバーを追加できます。認証方法は 2 つあります。

オプション 1：URL に API キーを指定する

API キーを URL に直接渡します。<your-api-key> を実際のTavily API キーに置き換えてください。

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

オプション 2：OAuth 認証フロー

URL に API キーを指定せずにサーバーを追加します。

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

追加後、認証フローを完了する必要があります。

1. claude を実行して Claude Code を起動します
2. /mcp と入力して MCP サーバー管理を開きます
3. Tavily サーバーを選択し、認証プロセスを完了します

**ヒント：**どちらのコマンドにも --scope user を追加すると、すべてのプロジェクトで Tavily MCP サーバーをグローバルに利用できます。

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

設定が完了すると、Tavily の検索、抽出、マッピング、クロールのツールを利用できます。

Cursor に接続する

⬆️ Cursor に追加 ⬆️ ボタンをクリックしてください。ほとんどの設定は自動で行われますが、API キーを追加するために設定を編集する必要があります。Tavily API キーはこちらから取得できます。

ボタンをクリックすると、Cursor にリダイレクトされます……

ステップ 1

インストールボタンをクリックします。

ステップ 2

MCP がインストールされていることを確認します。青いスライダーがオンになっていない場合は、手動でオンにしてください。また、Tavily API キーを設定に追加する必要があります。

ステップ 3

mcp.json ファイルにリダイレクトされるので、your-api-key を追加してください。

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

リモート MCP サーバーの OAuth フロー

Tavily リモート MCP サーバーは、安全な OAuth 認証に対応しており、互換性のあるクライアントにシームレスに接続して認証できます。

OAuth 認証の設定方法

A. MCP Inspector を使用する場合：

• MCP Inspector を開き、「Open Auth Settings」をクリックします。
• OAuth フローを選択し、次の手順を完了します：
  1. メタデータの検出
  2. クライアントの登録
  3. 認証の準備
  4. 認証をリクエストし、認証コードを取得
  5. トークンのリクエスト
  6. 認証完了

完了すると、Tavily リモート MCP サーバーに対して認証済みのリクエストを安全に送信できるアクセストークンが発行されます。

B. その他の MCP クライアントを使用する場合（例：Cursor）：

URL に Tavily API キーを含めずに、MCP クライアントで OAuth を使用するように設定できます。たとえば、mcp.json では次のように設定します：

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

保存された OAuth 認証情報を消去して再認証する必要がある場合は、次を実行します：

rm -rf ~/.mcp-auth

注記：

• OAuth 認証は任意です。上記の説明のとおり、URL のクエリパラメーター（?tavilyApiKey=...）に Tavily API キーを含めるか、Authorization ヘッダーに設定すれば、いつでも API キー認証を使用できます。

OAuth で使用する API キーの選択

OAuth 認証が成功した後、API キーに mcp_auth_default という名前を付けることで、使用するキーを指定できます：

• 個人アカウントで mcp_auth_default という名前のキーを設定すると、そのキーが認証フローで使用されます。
• mcp_auth_default という名前のキーがあるチームに所属している場合、そのキーが認証フローで使用されます。
• 個人用とチーム用の両方に mcp_auth_default という名前のキーがある場合、個人用のキーが優先されます。
• mcp_auth_default キーが設定されていない場合は、個人アカウントの default キーが使用されます。default キーも設定されていない場合は、最初に利用可能なキーが使用されます。

ローカル MCP

前提条件 🔧

始める前に、次のものが揃っていることを確認してください：

• Tavily API キー
  • Tavily API キーをお持ちでない場合は、こちらから無料アカウントに登録できます
• Claude Desktop または Cursor
• Node.js（v20 以上）
  • 次のコマンドを実行すると、Node.js がインストールされているか確認できます：
    • node --version
• Git がインストールされていること（Git を使用してインストールする場合のみ必要）
  • macOS の場合：brew install git
  • Linux の場合：
    • Debian/Ubuntu：sudo apt install git
    • RedHat/CentOS：sudo yum install git
  • Windows の場合：Git for Windows をダウンロードします

NPX で実行

npx -y tavily-mcp@latest 

デフォルトパラメーターの設定 ⚙️

DEFAULT_PARAMETERS 環境変数を使用して、tavily-search ツールのデフォルトのパラメーター値を設定できます。これにより、リクエストのたびにこれらのパラメーターを指定せずに、検索動作を設定できます。

設定例

export DEFAULT_PARAMETERS='{"include_images": true}'

クライアントからの使用例

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

エンドユーザーの識別（任意）

TAVILY_HUMAN_ID 環境変数を設定すると、リクエストの実行対象となるエンドユーザーを任意で識別できます。この変数が設定されている場合、Tavily MCP はすべての API 呼び出しで X-Human-Id ヘッダーとして転送し、ユーザーごとの分析を可能にします。

これは完全に任意です。設定しない場合、動作は変わりません。

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

プライバシーに関する注記： Tavily は保存前にサーバー側で human_id をハッシュ化（SHA-256）するため、値そのものが保存されることはありません。それでも、可能な場合はメールアドレスなどの個人を特定できる情報（PII）をそのまま使うのではなく、内部ユーザー ID などの不透明な識別子を使用してください。

謝辞 ✨

• MCP 仕様を提供する Model Context Protocol
• Claude Desktop を提供する Anthropic