MCP Tavily Web Search Server

🚀 网络搜索 MCP 服务器

本项目是一个基于 Tavily API 实现的 Model Context Protocol (MCP) 服务器，为用户提供强大的网络搜索工具。借助该服务器，AI 模型能够便捷地访问互联网，获取最新的信息，有效解决模型信息更新不及时的问题，提升其应用价值。

🚀 快速开始

此 MCP 服务器可让 AI 模型在对话过程中访问互联网信息，主要实现了 search_web_tool 工具，借助 Tavily API 进行网络搜索并返回结果。

✨ 主要特性

• 实时网络搜索：支持实时获取互联网最新信息。
• 可自定义搜索参数：
  • 搜索主题：涵盖通用、新闻、金融等不同领域。
  • 搜索深度：分为基础和高级两种模式。
  • 最大结果数：可自行设定返回的结果数量。
  • 时间范围过滤：支持按天、周、月、年进行筛选。
  • 域包含/排除：灵活控制搜索范围。

📦 安装指南

环境要求

• Python 3.13+
• uv - Python 包安装程序和解析器
• Tavily API 密钥（需在 tavily.com 注册获取）

安装步骤

1. 克隆仓库（如有必要）。
2. 使用 uv 创建虚拟环境（可选但推荐）：

uv venv
激活：source .venv/bin/activate  # Windows 上：.venv\Scripts\activate

3. 使用 uv 安装依赖项：

uv pip 同步

🔧 配置说明

1. 复制提供的模板创建 .env 文件：

cp env-sample .env

2. 将你的 Tavily API 密钥添加到 .env 文件中：

TAVILY_API_KEY=your-api-key-here

💻 使用示例

基础用法

使用 uv 运行服务器：

uv 运行 web_search_server.py

该服务器采用 stdio 传输方法进行 MCP 通信，可与支持模型上下文协议的各类 AI 系统集成。

工具参数

search_web_tool 接受以下参数：

• query (str, 必填)：搜索查询。
• search_topic (str, 可选)：搜索主题。可以是 "general"、"news" 或 "finance"，默认为 "general"。
• search_depth (str, 可选)：搜索深度。可以是 "basic" 或 "advanced"，默认为 "basic"。
• max_results (int, 可选)：要返回的最大结果数，默认为 1。
• time_range (str, 可选)：搜索的时间范围。可以是 "day"、"week"、"month" 或 "year"，默认为 None。
• include_domains (list[str], 可选)：要包含在搜索中的域列表。
• exclude_domains (list[str], 可选)：要从搜索中排除的域列表。

📚 详细文档

响应格式

工具返回一个搜索结果列表，每个结果包含：

• title：搜索结果标题
• url：搜索结果 URL
• content：搜索结果内容
• score：搜索结果的相关性评分

错误处理

若在搜索操作期间发生错误，工具将返回描述问题的错误消息。