Tavily MCP Server

Model Context Protocol（MCP）は、AI システムがさまざまなデータソースやツールとシームレスにやり取りできるようにするオープンスタンダードで、安全な双方向接続を実現します。

Anthropic が開発した Model Context Protocol（MCP）により、Claude などの AI アシスタントは、Tavily の高度な検索機能やデータ抽出機能をシームレスに統合できます。この統合により、AI モデルは高度なフィルタリングオプションやドメイン固有の検索機能を備えた、ウェブ情報へのリアルタイムアクセスが可能になります。

Tavily MCP サーバーが提供する機能：

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

📚 参考リソース

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

前提条件 🔧

始める前に、以下をご用意ください。

• 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 をダウンロードします

Tavily MCP サーバーのインストール ⚡

NPX で実行

npx -y tavily-mcp@latest 

Smithery 経由でインストール

Smithery 経由で Claude Desktop 用の Tavily MCP Server を自動的にインストールするには：

npx -y @smithery/cli install @tavily-ai/tavily-mcp --client claude

サーバーを単独で起動することもできますが、それだけではあまり役に立ちません。代わりに、MCP クライアントに統合してください。以下は、Claude Desktop アプリを tavily-mcp サーバーと連携するように設定する例です。

MCP クライアントの設定 ⚙️

このリポジトリでは、tavily-mcp サーバーと連携するための VS Code、Cursor、Claude Desktop の設定方法を説明します。

VS Code の設定 💻

ワンクリックでインストールするには、以下のインストールボタンのいずれかをクリックしてください。

手動インストール

まず、このセクションの上部に、必要に合ったインストールボタンがあるか確認してください。手動でインストールする場合は、次の手順に従ってください。

以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P（macOS では Cmd + Shift + P）を押して Preferences: Open User Settings (JSON) と入力すると開けます。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "tavily_api_key",
        "description": "Tavily API Key",
        "password": true
      }
    ],
    "servers": {
      "tavily": {
        "command": "npx",
        "args": ["-y", "tavily-mcp@latest"],
        "env": {
          "TAVILY_API_KEY": "${input:tavily_api_key}"
        }
      }
    }
  }
}

必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tavily_api_key",
      "description": "Tavily API Key",
      "password": true
    }
  ],
  "servers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "${input:tavily_api_key}"
      }
    }
  }
}

Cline の設定 🤖

Cline で Tavily MCP サーバーを設定する最も簡単な方法は、マーケットプレイスからワンクリックでインストールすることです。

1. VS Code で Cline を開きます
2. サイドバーの Cline アイコンをクリックします
3. 「MCP Servers」タブ（4 つの四角形）を開きます
4. 「Tavily」を検索し、「install」をクリックします
5. プロンプトが表示されたら、Tavily API キーを入力します

または、Cline で Tavily MCP サーバーを手動で設定することもできます。

1. Cline の MCP 設定ファイルを開きます。

   macOS の場合：

   # Using Visual Studio Code
   code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   
   # Or using TextEdit
   open -e ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   

   Windows の場合：

   code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   

2. Tavily サーバーの設定をファイルに追加します。

   your-api-key-here を実際の Tavily API キーに置き換えてください。

   {
     "mcpServers": {
       "tavily-mcp": {
         "command": "npx",
         "args": ["-y", "tavily-mcp@latest"],
         "env": {
           "TAVILY_API_KEY": "your-api-key-here"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. ファイルを保存します。Cline がすでに実行中の場合は、再起動してください。

4. Cline を使用すると、Tavily MCP ツールを利用できるようになります。会話の中で、tavily-search および tavily-extract ツールを直接使用するよう Cline に依頼できます。

Cursor の設定 🖥️

注：Cursor バージョン 0.45.6 以降が必要です

Cursor で Tavily MCP サーバーを設定するには、次の手順に従ってください。

1. Cursor の設定を開きます
2. Features > MCP Servers に移動します
3. 「+ Add New MCP Server」ボタンをクリックします
4. 以下の情報を入力します。
   • Name：サーバーのニックネーム（例：「tavily-mcp」）を入力します
   • Type：種類として「command」を選択します
   • Command：サーバーを実行するコマンドを入力します。

     env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@latest
     

     重要：your-api-key を Tavily API キーに置き換えてください。キーは app.tavily.com/home で取得できます。

サーバーを追加すると、MCP サーバーの一覧に表示されます。ツール一覧を読み込むには、MCP サーバーの右上にある更新ボタンを手動で押す必要がある場合があります。

Composer エージェントは、クエリに関連する場合、Tavily MCP ツールを自動的に使用します。実行したい内容を説明して、ツールの使用を明示的に依頼することをおすすめします（例：「AI に関する最新ニュースをウェブで検索するために tavily-search を使用してください」）。Mac では command + L を押してチャットを開き、画面上部の Composer オプションを選択します。送信ボタンの横で agent を選び、準備ができたらクエリを送信してください。

Claude Desktop アプリの設定 🖥️

macOS の場合：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows の場合：

code %APPDATA%\Claude\claude_desktop_config.json

Tavily サーバーの設定を追加します：

your-api-key-here を実際の Tavily API キーに置き換えてください。

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

2. Git によるインストール

1. リポジトリをクローンします：

git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp

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

npm install

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

npm run build

Claude デスクトップアプリの設定 ⚙️

上記のClaude デスクトップアプリの設定セクションに記載されている設定手順に従い、以下の JSON 設定を使用してください。

your-api-key-here を実際の Tavily API キーに、/path/to/tavily-mcp をお使いのシステム上でリポジトリをクローンした実際のパスに置き換えてください。

{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["/path/to/tavily-mcp/build/index.js"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude デスクトップアプリでの使用 🎯

インストールが完了し、Claude デスクトップアプリの設定が終わったら、tavily-mcp サーバーを表示するために、Claude デスクトップアプリを完全に終了してから再起動する必要があります。アプリの左下にハンマーアイコンが表示され、利用可能な MCP ツールを確認できます。ハンマーアイコンをクリックすると、tavily-search ツールと tavily-extract ツールの詳細が表示されます。

これで Claude は、tavily-search ツールと tavily-extract ツールを含む tavily-mcp サーバーに完全にアクセスできるようになります。以下の例を Claude デスクトップアプリに入力すると、tavily-mcp サーバーのツールが動作する様子を確認できます。

Tavily 検索の例

1. 一般的なウェブ検索：

Can you search for recent developments in quantum computing?

2. ニュース検索：

Search for news articles about AI startups from the last 7 days.

3. ドメインを指定した検索：

Search for climate change research on nature.com and sciencedirect.com

Tavily 抽出の例

1. 記事の内容を抽出：

Extract the main content from this article: https://example.com/article

✨ 検索と抽出を組み合わせる ✨

tavily-search ツールと tavily-extract ツールを組み合わせて、より複雑なタスクを実行することもできます。

Search for news articles about AI startups from the last 7 days and extract the main content from each article to generate a detailed report.

トラブルシューティング 🛠️

よくある問題

1. サーバーが見つからない

   • npm --verison を実行して npm のインストールを確認します
   • code ~/Library/Application\ Support/Claude/claude_desktop_config.json を実行して Claude Desktop の設定構文を確認します
   • node --version を実行して Node.js が正しくインストールされていることを確認します

2. NPX 関連の問題

• npx 関連のエラーが発生する場合は、代わりに npx 実行ファイルのフルパスを使用する必要がある場合があります。
• ターミナルで which npx を実行してパスを確認し、設定内の "command": "npx" の行を "command": "/full/path/to/npx" に置き換えてください。

3. API キーの問題
   • Tavily API キーが有効であることを確認します
   • API キーが設定ファイルに正しく設定されていることを確認します
   • API キーの前後に空白や引用符がないことを確認します

謝辞 ✨

• MCP 仕様の提供元である Model Context Protocol
• Claude Desktop の提供元である Anthropic