Tavily Anet MCP

🚀 Tavily-Anet-MCP Server

A Model Control Protocol (MCP) server implemented in Rust, offering powerful Tavily search and content extraction capabilities integrated through a standardized protocol. This server combines the Tavily API with the Anet MCP framework, enabling AI agents to perform web searches and extract content from URLs. It is designed for developers building AI agent systems, LLM-based tools, or research automation that requires up-to-date web information.

✨ Features

• ✅ Comprehensive Tavily search integration with full parameters
• 📄 Tavily content extraction from URLs
• 🔄 NATS as the messaging transport layer
• 🛠️ Support for JSON-RPC 2.0 API
• ⚡ Asynchronous request handling (using Tokio)
• 🔍 Advanced search features including domain filtering, time range, and topic selection

📦 Installation

Prerequisites

• Rust 1.70+
• A running NATS server or network access to one
• A Tavily API key (obtain from Tavily website)

Steps

Clone the repository and build the server:

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

Add your Tavily API key to the .env file:

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

🚀 Quick Start

Run the Server

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

# Start the Tavily MCP server
cargo run

Test the Server

You can use the included test client to test the server:

cargo run --example test_client

This will send various requests (initialization, list tools, search, extract) to the server and print the responses.

💻 Usage Examples

Available Tools

1. Tavily Search

A powerful web search tool that uses Tavily's AI search engine to provide comprehensive real-time results. Parameters:

• query (required): The search query string
• search_depth: "basic" or "advanced" (default: "basic")
• topic: "general" or "news" (default: "general")
• days: The number of days for the result range (for news topics)
• time_range: "day", "week", "month", "year"
• max_results: 5 - 20 (default: 10)
• include_images: Boolean
• include_raw_content: Boolean
• include_domains: An array of domains to include
• exclude_domains: An array of domains to exclude

Example:

{
  "query": "AI case studies",
  "search_depth": "advanced",
  "max_results": 5,
  "include_domains": ["tech.example.com"]
}

2. Tavily Extract

Extract structured data from a specified URL. Parameters:

• url (required): The URL to extract from
• extract_format: The output format ("json" or "csv", default: "json")
• fields: An array of specific fields to extract

Example:

{
  "url": "https://example.com/article",
  "extract_format": "json",
  "fields": ["Title", "Content", "Date"]
}

Search Example

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

Extract Example

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

📚 Documentation

Project Structure

Directory Structure

src/
├── main.rs          # Main program entry
├── lib.rs           # Library file (optional)
└── modules/         # Module directory (e.g., search, extraction)

Dependency Management

Manage project dependencies using Cargo.toml:

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

Configuration

Environment Variables

• TAVILY_API_KEY: The Tavily API key
• NATS_URL: The URL of the NATS server
• MCP_SUBJECT: The MCP subject (default: "mcp.requests")

Log Configuration

Control the log level via environment variables or a configuration file:

RUST_LOG=info cargo run

⚠️ Important Note

• Ensure the NATS server is correctly configured and running.
• Keep your Tavily API key secure to prevent leakage.
• The modular design facilitates easy expansion and maintenance.

📖 References

• Tavily Website
• Rust Documentation
• Tokio Documentation
• JSON-RPC 2.0 Specification

This document comprehensively introduces how to use the MCP server implemented in Rust to integrate Tavily's search and content extraction capabilities, making it suitable for developers as a reference.