tavily-mcp

Tavily MCP サーバー 🚀

🔌 Cline、Cursor、Claude Desktop、その他すべての MCP クライアントに対応しています！

Tavily MCP は、あらゆる MCP クライアントにも対応しています

📚 Tavily MCP と Neo4j MCP サーバーを組み合わせるチュートリアルです！

📚 VS Code の Cline に Tavily MCP を統合するチュートリアルです（デモ＋ユースケース例）。

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

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

Tavily MCP サーバーでは、次のことができます。

• tavily-search および tavily-extract ツールとのシームレスな連携
• tavily-search ツールによるリアルタイムのウェブ検索
• tavily-extract ツールによるウェブページからのインテリジェントなデータ抽出

前提条件 🔧

始める前に、次のものを用意してください。

• 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 [email protected]  

Smithery 経由でインストールする

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

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

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

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

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

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", "[email protected]"],
         "env": {
           "TAVILY_API_KEY": "your-api-key-here"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. ファイルを保存し、Cline がすでに起動している場合は再起動します。

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

Cursor の設定 🖥️

Note：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 [email protected]
     

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

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

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

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

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", "[email protected]"],
      "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 Search の例

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 Extract の例

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