Tavily

🚀 MCP Tavily プロジェクト

このプロジェクトは、Tavily API 用に実装されたモデルコンテキストプロトコル（MCP）サーバーです。高度な検索とコンテンツ抽出機能を提供します。

中国語ドキュメント

✨ 主な機能

• 複数の検索ツール：
  • search：カスタマイズ可能な基本的な検索機能
  • searchContext：関連性を高めるためのコンテキスト感知検索
  • searchQNA：質問応答に特化した検索
• コンテンツ抽出：URL からコンテンツを抽出し、設定可能なオプションがあります。
• 豊富な設定オプション：検索深度、フィルタリング、コンテンツの包含など、多数のオプションがあります。

MCP 設定の使用

Tavily MCP サーバーをあなたの MCP 設定に追加します。

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

⚠️ 重要提示

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

📚 ドキュメント

API リファレンス

検索ツール

• search：カスタムフィルタリングとソートオプションをサポートする基本的な検索機能です。
• searchContext：コンテキストを考慮した検索結果を提供し、関連性を向上させます。
• searchQNA：質問応答シナリオに特化した検索機能です。

抽出ツール

• extract：指定された URL から構造化されたコンテンツを抽出します。

レスポンス形式

すべてのツールのレスポンスは統一されたデータ形式に従っており、互換性と使いやすさを確保しています。

エラー処理

詳細なエラー情報とステータスコードが提供され、開発者が問題を迅速に特定できるようになっています。

📦 インストール

npm install

設定

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. あなたの Tavily API キーを設定します。

   export TAVILY_API_KEY=your_api_key
   

ビルド

npm run build

💻 使用例

MCP インスペクターを使用したデバッグ

開発とデバッグには MCP Inspector の使用をおすすめします。以下の機能を提供します。

• ツール呼び出しのテスト画面
• サーバーレスポンスの表示
• デバッグツールの実行
• サーバー状態の監視

🤝 貢献ガイド

貢献を歓迎します！Pull Request を提出するには、以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. Pull Request を開きます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。

サポート

ヘルプが必要な場合や問題が発生した場合：

• Tavily API：Tavily ドキュメント を参照してください。
• MCP 統合：MCP ドキュメント を参照してください。