Web Search

🚀 Cardea Web Search MCP Server

The Cardea Web Search MCP Server is a part of the Cardea project, offering web search capabilities via a Multi-Channel Protocol (MCP) server. It utilizes the Tavily API to retrieve and present web search results.

🚀 Quick Start

The Cardea Web Search MCP Server provides an efficient way to conduct web searches. Below, we'll introduce its tools, building, and running methods.

✨ Features

Tools

• search
  • Conduct a web search for the specified query.
  • Input parameters:
    • query: The query for the search.
  • Output parameters:
    • query: The original query.
    • response_time: The time taken to obtain the response.
    • results: A list of search results, each including:
      • content: The main content of the search result.
      • raw_content: The raw content of the search result.
      • score: The relevance score of the search result.
      • title: The title of the search result.
      • url: The URL of the search result.

📦 Installation

Build

# build mcp server
cargo build --release

💻 Usage Examples

Run

⚠️ Important Note

Before running the mcp server, you need to set the Tavily API key. You can obtain a key from Tavily.

export TAVILY_API_KEY=<your-api-key>

The CLI options of the mcp server are as follows:

Usage: cardea-web-search [OPTIONS]

Options:
  -s, --socket-addr <SOCKET_ADDR>  Socket address to bind to [default: 127.0.0.1:8010]
  -t, --transport <TRANSPORT>      Transport type to use (sse or stream-http) [default: stream-http] [possible values: sse, stream-http]
  -m, --max-results <MAX_RESULTS>  Max results to return [default: 5]
  -h, --help                       Print help
  -V, --version                    Print version

Now, let's start the mcp server by running the following command:

# run mcp server (stream-http)
./target/release/cardea-web-search --transport stream-http

# run mcp server (sse)
./target/release/cardea-web-search --transport sse

If started successfully, you will see the following output:

Starting Cardea Web Search MCP server on 127.0.0.1:8010