Tavily Anet MCP

🚀 Tavily-Anet-MCP 服務器

Tavily-Anet-MCP 服務器採用 Rust 實現了 模型控制協議 (MCP)，藉助標準化協議集成了強大的 Tavily 搜索與內容提取功能。它將 Tavily API 與 Anet MCP 框架相結合，讓 AI 代理能夠進行網絡搜索並從 URL 中提取內容。此服務器專為開發人員打造 AI 代理系統、基於大語言模型（LLM）的工具 或開展 研究自動化 而設計，可滿足對最新網絡信息的需求。

🚀 快速開始

運行服務器

# 在另一個終端啟動 NATS 服務器或確保已經有一個在運行
# 示例：
nats-server

# 啟動 Tavily MCP 服務器
cargo run

測試服務器

你可以使用包含的測試客戶端來測試服務器：

cargo run --example test_client

這將向服務器發送各種請求（初始化、列出工具、搜索、提取）並打印響應。

✨ 主要特性

• ✅ Tavily 搜索集成，帶有全面的參數
• 📄 Tavily 提取，用於從 URL 中提取內容
• 🔄 使用 NATS 作為消息傳遞的傳輸層
• 🛠️ 支持 JSON-RPC 2.0 API
• ⚡ 異步請求處理（使用 Tokio）
• 🔍 高級搜索功能，包括域名過濾、時間範圍和主題選擇

📦 安裝指南

克隆倉庫並構建服務器

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

💻 使用示例

搜索示例

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"}'

📚 詳細文檔

可用工具

1. Tavily 搜索

一個強大的網絡搜索工具，使用 Tavily 的 AI 搜索引擎提供全面的即時結果。 參數：

示例：

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

2. Tavily 提取

從指定 URL 中提取結構化數據。 參數：

示例：

{
  "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"] }

配置

環境變量

日誌配置

可以通過環境變量或配置文件控制日誌級別：

RUST_LOG=info cargo run

🔧 技術細節

該服務器將 Tavily API 與 Anet MCP 框架相結合，使用 Rust 語言開發。它利用 Tokio 實現異步請求處理，以提高性能。同時，使用 NATS 作為消息傳遞的傳輸層，支持 JSON-RPC 2.0 API，使得服務器具有良好的擴展性和兼容性。

📄 許可證

文檔未提及相關內容，暫不展示。

⚠️ 重要提示

• 確保 NATS 服務器已正確配置並運行。
• Tavily API 密鑰需妥善保管，避免洩露。

💡 使用建議

該服務器採用模塊化設計，便於擴展和維護，開發人員可根據需求進行定製。

🔍 參考資料

• Tavily 官網
• Rust 文檔
• Tokio 文檔
• JSON-RPC 2.0 規範