Tavily-Anet-MCP 服务器

这是一个用 Rust 实现的 模型控制协议 (MCP) 服务器，它通过标准化的协议提供 Tavily 搜索和内容提取功能。

该服务器将强大的 Tavily API 与 Anet MCP 框架集成，使 AI 代理能够执行网络搜索并从 URL 中提取内容。它专为构建 AI 代理系统、基于 LLM 的工具 或需要最新网络信息的 研究自动化 的开发人员而设计。

---

功能

• ✅ Tavily 搜索集成，具有全面的参数
• 📄 Tavily 提取，用于从 URL 检索内容
• 🔄 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

这将向服务器发送各种请求（initialize、listTools、search、extract）并打印响应。

---

可用工具

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: 要排除的域名数组

示例：

{
  "name": "tavily-search",
  "arguments": {
    "query": "人工智能的最新发展",
    "max_results": 5,
    "topic": "news",
    "days": 7
  }
}

2. Tavily 提取

一个用于从网页提取原始内容的工具。

参数：

• 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 搜索和提取实现
• models – Tavily API 响应结构
• utils – 格式化和辅助函数
• transport – NATS 消息传输层

---

开发

添加新功能

要使用其他 Tavily 功能扩展服务器：

1. 在 src/models/tavily.rs 中定义响应结构
2. 在 src/tools/ 中实现该工具，遵循 Tool trait
3. 在 src/utils/formatter.rs 中添加格式化函数
4. 在 src/main.rs 中注册该工具

---

故障排除

• 确保您的 Tavily API 密钥有效并且已在环境变量中正确设置
• 检查 NATS 服务器是否正在运行并且可以访问
• 验证请求格式是否与每个工具的预期输入模式匹配

---

许可证

MIT 许可证

---

致谢

该项目构建于 Anet MCP Server 框架之上，并与 Tavily API 集成。