MCPサーバ - Tavilyのソースを表示

== 概要 ==
Tavily MCP Server (tavily-ai/tavily-mcp) は、Model Context Protocol (MCP) を通じてAIアシスタントにTavilyのWeb検索・データ抽出機能を統合するための標準化されたツールインターフェースを提供するサーバである。<br>
Tavily社により開発・維持されており、MITライセンスの下で公開されている。<br>
<br>
Claude Desktop、Claude Code、VS Code、Cursor等、複数のMCPクライアント環境で動作する。<br>
リモートMCPサーバとローカルNPX実行の両方式に対応しており、リモートMCPサーバを使用する場合はNode.jsのインストールが不要である。<br>
<br>
このサーバを使用することにより、AIアシスタントがリアルタイムのWeb検索、URLからのコンテンツ抽出、Webサイトのクロール・マッピングを自然言語による指示で実行できるようになる。<br>
<br>
主な特徴は以下の通りである。<br>
* MCP標準に準拠したWeb検索・データ抽出インターフェース
* AI駆動のリアルタイム検索・コンテンツ抽出・クローリング・マッピングの4つのコアツールを提供
* Claude Desktop、Claude Code、VS Code、Cursor等の主要なMCPクライアントをサポート
* リモートMCPサーバ方式によるNode.js不要での利用に対応
* MIT Licenseの下でオープンソースとして公開
<br><br>

== Tavily MCP Serverの機能 ==
Tavily MCP Serverは、Web検索・コンテンツ抽出・クローリング・マッピングの4つのコアツールを提供する。<br>
<br>
==== tavily-search ====
AI駆動のリアルタイムWeb検索ツールである。<br>
指定したクエリに対してWeb検索を実行し、検索結果を返す。<br>
<br>
<center>
{| class="wikitable"
|+ tavily-search パラメータ一覧
! パラメータ !! 型 !! 必須 !! 説明
|-
| query || string || はい || 検索クエリ文字列
|-
| max_results || number || いいえ || 返される検索結果の最大数<br>(デフォルト: 5)
|-
| search_depth || string || いいえ || 検索の深さ<br><u>basic</u> または <u>advanced</u> (デフォルト: <u>basic</u>)
|-
| topic || string || いいえ || 検索トピック<br><u>general</u> または <u>news</u> (デフォルト: <u>general</u>)
|-
| time_range || string || いいえ || 検索する時間範囲<br><u>day</u>, <u>week</u>, <u>month</u>, <u>year</u> から選択
|-
| include_answer || boolean || いいえ || 検索結果にAI生成の回答を含める。<br>(デフォルト: <u>false</u>)
|-
| include_images || boolean || いいえ || 検索結果に画像を含める。<br>(デフォルト: <u>false</u>)
|-
| raw_content || boolean || いいえ || 未加工のHTMLコンテンツを含める。<br>(デフォルト: <u>false</u>)
|}
</center>
<br>
==== tavily-extract ====
指定したURLからコンテンツを抽出するツールである。<br>
複数のURLを一度に指定することができる。<br>
<br>
<center>
{| class="wikitable"
|+ tavily-extract パラメータ一覧
! パラメータ !! 型 !! 必須 !! 説明
|-
| urls || string[] || はい || コンテンツを抽出するURLのリスト
|-
| raw_content || boolean || いいえ || 未加工のHTMLコンテンツを含める。<br>(デフォルト: <u>false</u>)
|}
</center>
<br>
==== tavily-crawl ====
指定したURLを起点にWebサイトをクロールする構造化クローラーツールである。<br>
クロールの深度と幅を制御するパラメータを指定できる。<br>
<br>
<center>
{| class="wikitable"
|+ tavily-crawl パラメータ一覧
! パラメータ !! 型 !! 必須 !! 説明
|-
| url || string || はい || クロールを開始するURL
|-
| max_depth || number || いいえ || クロールの最大深度<br>(デフォルト: 2)
|-
| max_breadth || number || いいえ || クロールの最大幅 : 同階層で取得する最大ページ数<br>(デフォルト: 20)
|}
</center>
<br>
==== tavily-map ====
指定したWebサイトの全体構造をマッピングするツールである。<br>
サイトのURL構造を一覧化して取得する。<br>
<br>
<center>
{| class="wikitable"
|+ tavily-map パラメータ一覧
! パラメータ !! 型 !! 必須 !! 説明
|-
| url || string || はい || マッピングするWebサイトのURL
|}
</center>
<br><br>

== APIキーの取得 ==
Tavily MCP Serverの使用にはTavily APIキーが必要である。<br>
以下の手順でAPIキーを取得する。<br>
<br>
# https://app.tavily.com https://app.tavily.com にアクセスする
# アカウントを作成する。(Googleアカウント または GitHubアカウントでのサインアップも可)
# ダッシュボードからAPIキーを取得する。
<br>
無料プランでは、月間1,000 APIクレジットが利用できる。<br>
<br><br>

== 動作要件 ==
==== 共通の要件 ====
OS問わず共通して必要な要件を以下に示す。<br>
<br>
* Tavily APIキー
*: Tavily MCP Serverの全機能を利用するために必要
* Node.js v18以上 (ローカルNPX実行の場合のみ)
*: <code>npx</code> コマンドを使用してTavily MCP Serverを実行するために必要
*: リモートMCPサーバを使用する場合は不要
* npmパッケージマネージャ (ローカルNPX実行の場合のみ)
*: Node.jsに付属するパッケージマネージャ
<br><br>

== インストール ==
==== リモートMCPサーバ (推奨) ====
リモートMCPサーバ方式はNode.jsのインストールが不要で、全プラットフォームに対応しているため推奨の方式である。<br>
<br>
以下のURLをMCPクライアントの設定ファイルに指定する。<br>
* https://mcp.tavily.com/mcp/?tavilyApiKey=<TavilyのAPIキー>
<br>
Claude Desktopの設定ファイルに以下の内容を追記する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "tavily": {
       "url": "https://mcp.tavily.com/mcp/?tavilyApiKey=<TavilyのAPIキー>"
     }
   }
 }
 </syntaxhighlight>
<br>
==== ローカルNPXでの実行 ====
Node.js v18以上がインストールされている環境では、<code>npx</code> コマンドを使用してTavily MCP Serverをローカルで実行できる。<br>
<br>
Claude Desktopの設定ファイルに以下の内容を追記する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "tavily": {
       "command": "npx",
       "args": ["-y", "tavily-mcp@latest"],
       "env": {
         "TAVILY_API_KEY": "<TavilyのAPIキー>"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
==== ソースからのインストール ====
GitHubリポジトリからソースコードを取得してインストールする場合は、以下のコマンドを実行する。<br>
<br>
 git clone https://github.com/tavily-ai/tavily-mcp.git
 cd tavily-mcp
 
 npm install
 npm run build
<br><br>

== 設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。<br>
<br>
Claude Desktopの設定ファイルを以下に示す。<br>
* Linux
*: <u>~/.config/Claude/claude_desktop_config.json</u>
* MacOS
*: <u>~/Library/Application Support/Claude/claude_desktop_config.json</u>
* Windows
*: <u>%APPDATA%\Claude\claude_desktop_config.json</u>
<br>
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルに以下の内容を追記する。<br>
<br>
* リモートMCPサーバを使用する場合は、以下の内容を追記する。
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "tavily": {
       "url": "https://mcp.tavily.com/mcp/?tavilyApiKey=<TavilyのAPIキー>"
     }
   }
 }
 </syntaxhighlight>
*: <br>
* ローカルNPXを使用する場合は、以下の内容を追記する。
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "tavily": {
       "command": "npx",
       "args": ["-y", "tavily-mcp@latest"],
       "env": {
         "TAVILY_API_KEY": "<TavilyのAPIキー>"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。<br>
<br>
==== Claude Codeでの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してMCPサーバを追加できる。<br>
<br>
リモートMCPサーバを使用する場合は、以下のコマンドを実行する。<br>
<br>
 claude mcp add --transport sse tavily https://mcp.tavily.com/sse/?tavilyApiKey=<TavilyのAPIキー>
<br>
ローカルNPXを使用する場合は、以下のコマンドを実行する。<br>
<br>
 claude mcp add tavily -- npx -y tavily-mcp@latest
<br>
ローカルNPXを使用する場合は、環境変数 <code>TAVILY_API_KEY</code> を設定する必要がある。<br>
<br>
 export TAVILY_API_KEY="<TavilyのAPIキー>"
<br>
==== VS Codeでの設定 ====
VS Codeの <u>settings.jsonファイル</u> に以下の内容を追記する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcp": {
     "servers": {
       "tavily": {
         "url": "https://mcp.tavily.com/mcp/?tavilyApiKey=<TavilyのAPIキー>"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
==== Cursorでの設定 ====
Cursorの <u>mcp.jsonファイル</u> に以下の内容を追記する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "tavily": {
       "url": "https://mcp.tavily.com/mcp/?tavilyApiKey=<TavilyのAPIキー>"
     }
   }
 }
 </syntaxhighlight>
<br>
==== 環境変数の設定 ====
下表に、Tavily MCP Serverの動作に関わる環境変数を示す。<br>
<br>
<center>
{| class="wikitable"
|+ 環境変数一覧
! 環境変数 !! 説明 !! 必須
|-
| <code>TAVILY_API_KEY</code> || Tavily API認証キー || はい
|-
| <code>DEFAULT_PARAMETERS</code> || デフォルトパラメータ (JSON形式) || いいえ
|}
</center>
<br>
OS別の環境変数設定コマンドを以下に示す。<br>
<br>
* Linux / MacOS
*: <syntaxhighlight lang="sh">
 export TAVILY_API_KEY="<TavilyのAPIキー>"
 </syntaxhighlight>
*: <br>
* Windows (PowerShell)
*: <syntaxhighlight lang="powershell">
 $env:TAVILY_API_KEY = "<TavilyのAPIキー>"
 </syntaxhighlight>
*: <br>
* Windows (コマンドプロンプト)
*: <syntaxhighlight lang="text">
 set TAVILY_API_KEY=<TavilyのAPIキー>
 </syntaxhighlight>
<br><br>

== 使用方法 ==
Tavily MCP Serverの各ツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。<br>
<br>
==== Web検索の例 ====
Web検索に関する操作例を以下に示す。<br>
<br>
* 最新情報を検索する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 最新のAI技術トレンドについて検索してください。
 </syntaxhighlight>
*: <br>
* 特定期間のニュースを検索する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 今週のオープンソースAIに関するニュースを検索してください。
 </syntaxhighlight>
*: <br>
==== コンテンツ抽出の例 ====
URLからのコンテンツ抽出に関する操作例を以下に示す。<br>
<br>
* 指定URLからコンテンツを抽出する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 以下のURLからコンテンツを抽出してください: https://example.com/article
 </syntaxhighlight>
*: <br>
==== Webクローリングの例 ====
Webサイトのクローリングに関する操作例を以下に示す。<br>
<br>
* ドキュメントサイトの情報を収集する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 https://docs.example.com のドキュメントサイトをクロールして、主要な情報を収集してください。
 </syntaxhighlight>
*: <br>
==== Webサイトマッピングの例 ====
Webサイト構造のマッピングに関する操作例を以下に示す。<br>
<br>
* サイト全体の構造を把握する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 https://example.com のサイト構造をマッピングしてください。
 </syntaxhighlight>
*: <br>
<br><br>

== トラブルシューティング ==
==== 共通の問題 ====
OS問わず発生する可能性がある問題と対処法を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 対処法
|-
| <code>npx</code> コマンドが動作しない || Node.js v18以上がインストールされているか確認する。<br><code>npm cache clean --force</code> を実行してキャッシュをクリアする。
|-
| NVMを使用している場合に <code>npx</code> が見つからない || NVMで管理されているNode実行ファイルへの完全なパスを設定ファイルに指定する。
|-
| サーバへの接続エラーが発生する || ネットワーク接続を確認する。<br>ファイアウォール設定でTavily APIへのアクセスが許可されているか確認する。
|-
| タイムアウトエラーが発生する || tavily-crawlの <u>max_depth</u> および <u>max_breadth</u> の値を小さくする。
|}
</center>
<br>
==== APIキーに関する問題 ====
APIキーの設定・認証に関する問題と対処法を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ APIキートラブルシューティング
! 問題 !! 対処法
|-
| 認証エラー (401 Unauthorized) が発生する || APIキーが正しいか確認する。<br>[https://app.tavily.com https://app.tavily.com] のダッシュボードでAPIキーを再生成する。
|-
| APIクレジットが不足している || 現在のクレジット残高をダッシュボードで確認する。<br>プランのアップグレードを検討する。
|-
| 環境変数が認識されない || <code>TAVILY_API_KEY</code> が正しく設定されているか確認する。<br>MCPクライアントを再起動する。<br>~/.profileファイル等に環境変数の設定を追加する。
|}
</center>
<br><br>

== 関連リソース ==
* [https://docs.tavily.com/documentation/mcp 公式ドキュメント]
* [https://github.com/tavily-ai/tavily-mcp GitHubリポジトリ]
* [https://app.tavily.com APIダッシュボード]
* [https://docs.tavily.com Tavilyドキュメント]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Tavily,MCP,Model Context Protocol,tavily-mcp,Claude,AI,Web検索,検索,API,Web Scraping,Web Crawling,抽出,クロール,マッピング
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]