Tavily MCP

🚀 [Tavily Crawl Beta]

Model Context Protocol (MCP)は、AIシステムが様々なデータソースやツールとシームレスにやり取りできるようにするオープン標準で、安全な双方向接続を促進します。Tavily MCPサーバーは、検索、抽出、マッピング、クロールツールなどの機能を提供します。

🎉 v0.2.1でtavily-crawl + tavily-mapが登場！ 🎉

Model Context Protocol (MCP)は、AIシステムが様々なデータソースやツールとシームレスにやり取りできるようにするオープン標準で、安全な双方向接続を促進します。

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

Tavily MCPサーバーは以下を提供します：

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

📚 役立つリソース

• Tutorial Tavily MCPとNeo4j MCPサーバーを組み合わせる方法
• Tutorial 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をダウンロードします。

📦 インストール

NPXで実行

npx -y tavily-mcp@0.2.1  

Smitheryを介してインストール

Tavily MCP Server for Claude Desktopを自動的にインストールするには、以下を実行します：

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

サーバーを単独で起動することもできますが、単独ではあまり役に立たない場合があります。代わりに、MCPクライアントに統合する必要があります。以下は、Claude Desktopアプリをtavily-mcpサーバーと連携するように設定する方法の例です。

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

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

💻 VS Codeの設定

ワンクリックインストールを行うには、以下のインストールボタンのいずれかをクリックします：

手動インストール

まず、このセクションの上部にあるインストールボタンがあるかどうかを確認してください。手動インストールを好む場合は、以下の手順に従います：

VS Codeのユーザー設定 (JSON) ファイルに以下の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@0.2.1"],
        "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@0.2.1"],
      "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の場合：

   # Visual Studio Codeを使用する場合
   code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   
   # または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@0.2.1"],
         "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. 以下の情報を入力します：
   • 名前：サーバーのニックネームを入力します (例："tavily-mcp")
   • タイプ："command" を選択します。
   • コマンド：サーバーを実行するコマンドを入力します：

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

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

サーバーを追加した後、MCPサーバーのリストに表示されるはずです。ツールリストを表示するには、MCPサーバーの右上隅にある更新ボタンを手動で押す必要がある場合があります。

Composer Agentは、関連するクエリがあると自動的にTavily MCPツールを使用します。ツールを使用することを明示的に要求することが望ましいです (例："User tavily-search to search the web for the latest news on AI")。Macではコマンド + Lを押してチャットを開き、画面上部のComposerオプションを選択し、送信ボタンの横のエージェントを選択し、準備ができたらクエリを送信します。

🖥️ Claude Desktopアプリの設定

macOSの場合：

# 設定ファイルが存在しない場合は作成します
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 設定ファイルをTextEditで開きます
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 代替方法：Visual Studio Codeを使用する場合 (VS Codeがインストールされている必要があります)
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@0.2.1"],
      "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 Desktopアプリの設定

上記の Claude Desktopアプリの設定 セクションに記載されている設定手順に従い、以下の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 Desktopアプリでの使用方法

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

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

Tavily Searchの例

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

量子コンピューティングの最近の開発を検索してくれますか？

2. ニュース検索：

過去7日間のAIスタートアップに関するニュース記事を検索してください。

3. ドメイン固有の検索：

nature.comとsciencedirect.comで気候変動研究を検索してください。

Tavily Extractの例

1. 記事内容の抽出：

この記事の主要な内容を抽出してください：https://example.com/article

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

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

過去7日間のAIスタートアップに関するニュース記事を検索し、各記事の主要な内容を抽出して詳細なレポートを作成してください。

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

一般的な問題

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キーの周りに空白や引用符がないことを確認します。

✨ 謝辞

• Model Context Protocol MCP仕様の提供
• Anthropic Claude Desktopの開発