Tavily-Anet-MCP Server

Tavily-Anet-MCP サーバー

標準化されたプロトコルを通じて、Tavily の検索機能とコンテンツ抽出機能を提供する Model Control Protocol (MCP) サーバーの Rust 実装です。

このサーバーは、強力な Tavily API と Anet MCP フレームワークを統合し、AI エージェントがウェブ検索や URL からのコンテンツ抽出を実行できるようにします。最新のウェブ情報を必要とする AI エージェントシステム、LLM ベースのツール、リサーチの自動化を構築する開発者向けに設計されています。

---

機能

• ✅ 包括的なパラメーターを備えた Tavily 検索の統合
• 📄 URL からコンテンツを取得する Tavily Extract
• 🔄 メッセージ転送用の NATS トランスポート層
• 🛠️ JSON-RPC 2.0 互換 API
• ⚡ Tokio による非同期リクエスト処理
• 🔍 ドメインフィルタリング、時間範囲、トピック選択などの高度な検索機能

---

要件

• Rust 1.70 以降
• ローカルで実行中、またはネットワーク経由でアクセス可能な NATS サーバー
• Tavily API キー（Tavily のウェブサイトから取得してください）

---

インストール

リポジトリをクローンして、サーバーをビルドします。

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

.env ファイルに Tavily API キーを追加します。

TAVILY_API_KEY=your_api_key_here
NATS_URL=nats://localhost:4222
MCP_SUBJECT=mcp.requests

---

はじめに

サーバーの実行

# Start a NATS server in another terminal or ensure one is already running
# Example:
nats-server

# Run the Tavily MCP server
cargo run

サーバーのテスト

付属のテストクライアントを使用して、サーバーをテストできます。

cargo run --example test_client

これにより、サーバーにさまざまなリクエスト（initialize、listTools、search、extract）が送信され、レスポンスが出力されます。

---

利用可能なツール

1. Tavily Search

Tavily の AI 検索エンジンを使用して、包括的でリアルタイムな検索結果を提供する強力なウェブ検索ツールです。

パラメーター：

• query（必須）：検索クエリ文字列
• search_depth：「basic」または「advanced」（デフォルト：「basic」）
• topic：「general」または「news」（デフォルト：「general」）
• days：結果の対象とする過去の日数（news トピックの場合）
• time_range：「day」、「week」、「month」、「year」
• max_results：5～20（デフォルト：10）
• include_images：ブール値
• include_raw_content：ブール値
• include_domains：含めるドメインの配列
• exclude_domains：除外するドメインの配列

例：

{
  "name": "tavily-search",
  "arguments": {
    "query": "Latest developments in AI",
    "max_results": 5,
    "topic": "news",
    "days": 7
  }
}

2. Tavily Extract

ウェブページから生のコンテンツを抽出するツールです。

パラメーター：

• urls（必須）：コンテンツを抽出する URL の配列
• extract_depth：「basic」または「advanced」（デフォルト：「basic」）
• include_images：ブール値（デフォルト：false）

例：

{
  "name": "tavily-extract",
  "arguments": {
    "urls": ["https://www.rust-lang.org/"],
    "extract_depth": "advanced",
    "include_images": true
  }
}

---

アーキテクチャ

サーバーはモジュール設計を採用しています。

• tools – Tavily Search と Extract の実装
• models – Tavily API のレスポンス構造
• utils – フォーマット処理とヘルパー関数
• transport – NATS メッセージトランスポート層

---

開発

新機能の追加

Tavily の機能を追加してサーバーを拡張するには、次の手順に従ってください。

1. src/models/tavily.rs にレスポンス構造を定義します
2. Tool トレイトに従って、src/tools/ にツールを実装します
3. src/utils/formatter.rs にフォーマット関数を追加します
4. src/main.rs にツールを登録します

---

トラブルシューティング

• Tavily API キーが有効で、環境変数に正しく設定されていることを確認してください
• NATS サーバーが実行中で、アクセス可能であることを確認してください
• リクエスト形式が、各ツールで想定される入力スキーマに合っていることを確認してください

---

ライセンス

MIT License

---

謝辞

このプロジェクトは、Anet MCP Server フレームワークを基盤とし、Tavily API と統合しています。