Web Search

🚀 Cardea Web Search MCP Server

Cardea Web Search MCP Server 是 Cardea 项目的一个组件，它通过多通道协议（MCP）服务器提供网页搜索功能。该服务器借助 Tavily API 来获取并返回网页搜索结果。

🚀 快速开始

✨ 主要特性

• 搜索功能：可针对给定的查询进行网页搜索。
• 详细输出：返回搜索结果的详细信息，包括内容、原始内容、相关性得分、标题和 URL 等。

📦 安装指南

# 构建 MCP 服务器
cargo build --release

💻 使用示例

基础用法

在运行 MCP 服务器之前，你需要设置 Tavily API 密钥。你可以从 Tavily 获取密钥。

export TAVILY_API_KEY=<your-api-key>

MCP 服务器的命令行选项如下：

Usage: cardea-web-search [OPTIONS]

Options:
  -s, --socket-addr <SOCKET_ADDR>  要绑定的套接字地址 [默认值: 127.0.0.1:8010]
  -t, --transport <TRANSPORT>      要使用的传输类型 (sse 或 stream-http) [默认值: stream-http] [可能的值: sse, stream-http]
  -m, --max-results <MAX_RESULTS>  要返回的最大结果数 [默认值: 5]
  -h, --help                       打印帮助信息
  -V, --version                    打印版本信息

现在，让我们通过运行以下命令来启动 MCP 服务器：

# 以 stream-http 方式运行 MCP 服务器
./target/release/cardea-web-search --transport stream-http

# 以 sse 方式运行 MCP 服务器
./target/release/cardea-web-search --transport sse

如果成功启动，你将看到以下输出：

Starting Cardea Web Search MCP Server on 127.0.0.1:8010

📚 详细文档

工具介绍

• search
  • 功能：针对给定的查询进行网页搜索。
  • 输入参数：
    • query：要搜索的查询内容。
  • 输出参数：
    • query：原始查询内容。
    • response_time：获取响应所花费的时间。
    • results：搜索结果列表，每个结果包含：
      • content：搜索结果的主要内容。
      • raw_content：搜索结果的原始内容。
      • score：搜索结果的相关性得分。
      • title：搜索结果的标题。
      • url：搜索结果的 URL。

🔧 技术细节

该服务器借助 Tavily API 来获取网页搜索结果，通过多通道协议（MCP）为用户提供搜索服务。在运行服务器之前，需要设置 Tavily API 密钥，以确保能够正常访问 Tavily 的搜索服务。服务器支持两种传输类型：sse 和 stream-http，用户可以根据需求进行选择。同时，还可以通过命令行选项设置服务器的绑定地址和返回的最大结果数。

📄 许可证

文档中未提及相关许可证信息。