Tavily Anet MCP

🚀 Tavily-Anet-MCP サーバー

Rust で実装された モデル制御プロトコル (MCP) サーバーです。標準化されたプロトコルを通じて、強力な Tavily 検索とコンテンツ抽出機能を提供します。このサーバーは、Tavily API と Anet MCP フレームワークを組み合わせることで、AI エージェントがウェブ検索を実行し、URL からコンテンツを抽出できるようにします。最新のウェブ情報を必要とする AI エージェントシステム、LLM ベースのツール、または 研究自動化 を開発する開発者向けに設計されています。

✨ 主な機能

• ✅ 包括的なパラメータを備えた Tavily 検索の統合
• 📄 URL からコンテンツを抽出する Tavily 抽出機能
• 🔄 メッセージングのトランスポート層として 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

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

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

💻 使用例

サーバーの起動

# 別のターミナルで NATS サーバーを起動するか、既に実行中であることを確認する
# 例：
nats-server

# Tavily MCP サーバーを起動する
cargo run

サーバーのテスト

含まれているテストクライアントを使用してサーバーをテストできます：

cargo run --example test_client

これにより、サーバーにさまざまなリクエスト（初期化、ツールの一覧表示、検索、抽出）が送信され、応答が表示されます。

利用可能なツール

1. Tavily 検索

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

• query（必須）：検索クエリ文字列
• search_depth： "basic" または "advanced"（デフォルト："basic"）
• topic： "general" または "news"（デフォルト："general"）
• days： 結果の日数範囲（ニューストピックの場合）
• time_range： "day", "week", "month", "year"
• max_results： 5 - 20（デフォルト：10）
• include_images： ブール値
• include_raw_content： ブール値
• include_domains： 含めるドメインの配列
• exclude_domains： 除外するドメインの配列

例：

{
  "query": "AI 案例研究",
  "search_depth": "advanced",
  "max_results": 5,
  "include_domains": ["tech.example.com"]
}

2. Tavily 抽出

指定された URL から構造化データを抽出します。 パラメータ：

• url（必須）： 抽出する URL
• extract_format： 出力形式（"json" または "csv"、デフォルト："json"）
• fields： 抽出する具体的なフィールドの配列

例：

{
  "url": "https://example.com/article",
  "extract_format": "json",
  "fields": ["标题", "内容", "日期"]
}

プロジェクト構造

ディレクトリ構造

src/
├── main.rs          # メインプログラムのエントリーポイント
├── lib.rs           # ライブラリファイル（オプション）
└── modules/         # モジュールディレクトリ（検索、抽出など）

依存関係の管理

Cargo.toml を使用してプロジェクトの依存関係を管理します：

[dependencies]
tokio = { version = "1.0", features = ["full"] }
jsonrpc = "v2"
nats = "0.16"
serde = { version = "1.0", features = ["derive"] }

設定

環境変数

• TAVILY_API_KEY： Tavily API のキー
• NATS_URL： NATS サーバーの URL
• MCP_SUBJECT： MCP トピック（デフォルト："mcp.requests"）

ログ設定

環境変数または設定ファイルを使用してログレベルを制御できます：

RUST_LOG=info cargo run

サンプルの使用方法

検索の例

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{"query": "AI 案例研究", "search_depth": "advanced", "max_results": 5}'

抽出の例

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article", "extract_format": "json"}'

注意事項

⚠️ 重要提示

• NATS サーバーが正しく構成され、実行中であることを確認してください。
• Tavily API キーは適切に保管し、漏洩を防いでください。
• モジュール化された設計により、拡張と保守が容易です。

参考資料

• Tavily 公式サイト
• Rust ドキュメント
• Tokio ドキュメント
• JSON-RPC 2.0 仕様

このドキュメントは、Rust で実装された MCP サーバーを使用して Tavily の検索とコンテンツ抽出機能を統合する方法を完全に説明しており、開発者が参考にするのに適しています。