Tavily

Tavily MCPサーバー

Tavily MCPサーバーが提供するもの:

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

📚 役立つリソース

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

リモートMCPサーバー

ローカルで実行する代わりに、TavilyのリモートMCPサーバーに直接接続します。これにより、ローカルへのインストールや設定なしでシームレスな体験が得られます。

リモートMCPサーバーのURLとTavily APIキーを使用するだけです:

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は、Anthropicの公式CLIツール for Claudeです。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認証フロー

APIキーをURLに含めずにサーバーを追加します:

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への接続

⬆️ Add to 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キーを含めずにOAuthを使用するようにMCPクライアントを設定できます。例えば、mcp.json で:

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

保存されたOAuth認証情報をクリアして再認証する必要がある場合は、以下を実行します:

rm -rf ~/.mcp-auth

注意:

• OAuth認証はオプションです。上記のように、Tavily APIキーをURLクエリパラメータ(?tavilyApiKey=...)に含めるか、Authorization ヘッダーに設定することで、いつでもAPIキー認証を使用できます。

OAuthで使用されるAPIキーの選択

OAuth認証が成功した後、mcp_auth_default という名前を付けることで、どのAPIキーを使用するかを制御できます:

• 個人アカウントに 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のような不透明な識別子を優先してください。

謝辞 ✨

• Model Context Protocol (MCP仕様)
• Anthropic (Claude Desktop)