Github 9a2

🚀 Tavily-MCP プロジェクトドキュメント

Tavily-MCP は、Claude デスクトップアプリで使用できる便利なツールです。このドキュメントでは、Tavily-MCP のインストール、設定、使用方法、機能の例、トラブルシューティングなどについて説明します。

🚀 クイックスタート

Tavily-MCP をすぐに使い始めるには、以下の手順に従ってインストールと設定を行ってください。

✨ 主な機能

• Tavily Search：通用ネットワーク検索、ニュース検索、特定分野検索などの多様な検索機能を提供します。
• Tavily Extract：指定した記事から主要内容を抽出することができます。
• Search と Extract の組み合わせ：より複雑なタスクを実行することが可能です。

📦 インストール

1. npm を使用したインストール

ステップ 1: 依存関係のインストール

ターミナルまたはコマンドプロンプトで以下のコマンドを実行して、Tavily-MCP をインストールします。

npm install tavily-mcp

ステップ 2: サーバーの起動

インストールが成功したら、Tavily-MCP サーバーを起動します。

tavily-mcp start

2. 手動インストール

ステップ 1: リポジトリのクローン

ターミナルまたはコマンドプロンプトで以下のコマンドを実行して、Tavily-MCP リポジトリをクローンします。

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

ステップ 2: 依存関係のインストール

リポジトリディレクトリに移動した後、すべての依存関係をインストールします。

npm install

ステップ 3: プロジェクトのビルド

プロジェクトをビルドして、実行可能ファイルを生成します。

npm run build

📚 ドキュメント

設定ガイド

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

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

   • macOS:

     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     

   • Windows:

     code %APPDATA%\Claude\claude_desktop_config.json
     

2. Tavily-MCP サーバーの設定を追加します。

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

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

使用ガイド

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

1. インストールが完了したら、Claude デスクトップアプリを完全に閉じてから再度開き、設定を有効にします。
2. アプリの下部左側にハンマーアイコンが表示され、利用可能な MCP ツールがあることを示します。このアイコンをクリックすると、詳細情報を確認できます。

💻 使用例

Tavily Search の例

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

   量子コンピューティング分野の最新の進展を調べてくれますか？
   

2. ニュース検索：

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

3. 特定分野の検索：

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

Tavily Extract の例

1. 記事内容の抽出：

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

Search と Extract の組み合わせ使用

Tavily-Search と Tavily-Extract ツールを組み合わせて、より複雑なタスクを実行できます。

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

🔧 技術詳細

トラブルシューティング

一般的な問題

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

   • npm のインストール状態を確認し、npm --version を実行します。
   • Claude デスクトップアプリの設定ファイルの構文を確認し、code ~/Library/Application\ Support/Claude/claude_desktop_config.json を実行します。
   • Node.js が正しくインストールされていることを確認し、node --version を実行します。

2. NPX 関連の問題

   • npx 関連のエラーが発生した場合は、設定内の "command": "npx" を npx の完全パスに置き換えます。

     which npx
     

     その後、設定内で以下のように置き換えます。

     "command": "/full/path/to/npx"
     

3. API キーの問題

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

📄 ライセンス

謝辞

• Model Context Protocol が MCP 仕様を提供しています。
• Anthropic が Claude デスクトップアプリを提供しています。