2026年2月22日 (日) 22:41にWikiによる

2026-02-22T22:41:05Z

← 古い版		2026年2月23日 (月) 07:41時点における版
277行目:		277行目:
	*: <br>		*: <br>
	* Windows (コマンドプロンプト)		* Windows (コマンドプロンプト)
	*: <syntaxhighlight lang="~~cmd~~">		*: <syntaxhighlight lang="text">
	set TAVILY_API_KEY=<TavilyのAPIキー>		set TAVILY_API_KEY=<TavilyのAPIキー>
	</syntaxhighlight>		</syntaxhighlight>

Wiki: ページの作成:「== 概要 == Tavily MCP Server (tavily-ai/tavily-mcp) は、Model Context Protocol (MCP) を通じてAIアシスタントにTavilyのWeb検索・データ抽出機能を統合するための標準化されたツールインターフェースを提供するサーバである。
Tavily社により開発・維持されており、MITライセンスの下で公開されている。

Claude Desktop、Claude Code、VS Code、Cursor等、複数のMCPクライ…」

2026-02-22T22:39:26Z

ページの作成:「== 概要 == Tavily MCP Server (tavily-ai/tavily-mcp) は、Model Context Protocol (MCP) を通じてAIアシスタントにTavilyのWeb検索・データ抽出機能を統合するための標準化されたツールインターフェースを提供するサーバである。 Tavily社により開発・維持されており、MITライセンスの下で公開されている。 Claude Desktop、Claude Code、VS Code、Cursor等、複数のMCPクライ…」

新規ページ

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

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

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

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

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

npm install
npm run build
 

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

== 使用方法 ==
Tavily MCP Serverの各ツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== Web検索の例 ====
Web検索に関する操作例を以下に示す。 
 
* 最新情報を検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

最新のAI技術トレンドについて検索してください。
</syntaxhighlight>
*: 
* 特定期間のニュースを検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

今週のオープンソースAIに関するニュースを検索してください。
</syntaxhighlight>
*: 
==== コンテンツ抽出の例 ====
URLからのコンテンツ抽出に関する操作例を以下に示す。 
 
* 指定URLからコンテンツを抽出する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下のURLからコンテンツを抽出してください: https://example.com/article
</syntaxhighlight>
*: 
==== Webクローリングの例 ====
Webサイトのクローリングに関する操作例を以下に示す。 
 
* ドキュメントサイトの情報を収集する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

https://docs.example.com のドキュメントサイトをクロールして、主要な情報を収集してください。
</syntaxhighlight>
*: 
==== Webサイトマッピングの例 ====
Webサイト構造のマッピングに関する操作例を以下に示す。 
 
* サイト全体の構造を把握する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

https://example.com のサイト構造をマッピングしてください。
</syntaxhighlight>
*: 
 

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

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

{{#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__
[[カテゴリ:設定]]

MCPサーバ - Tavily - 版の履歴

2026年2月22日 (日) 22:41にWikiによる