Web Search MCP Server

Web Search MCP 服务

一个使用 Tavily API 提供网页搜索工具的模型上下文协议（MCP）服务。此服务可让 AI 模型搜索互联网并获取最新信息。

概述

此 MCP 服务实现了一个工具：

• search_web_tool：使用 Tavily API 搜索网页并返回相关搜索结果。

此服务充当 AI 模型与 Tavily 搜索引擎之间的桥梁，使模型能够在对话过程中访问互联网中的最新信息。

功能

• 实时网页搜索能力
• 可自定义搜索参数：
  • 搜索主题（general、news、finance）
  • 搜索深度（basic、advanced）
  • 最大结果数
  • 时间范围筛选（day、week、month、year）
  • 包含或排除的域名

要求

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

安装

1. 克隆仓库（如适用）

2. 使用 uv 设置虚拟环境（可选，但建议执行）：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 使用 uv 安装依赖：

   uv pip sync
   

配置

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

   cp env-sample .env
   

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

   TAVILY_API_KEY=your-api-key-here
   

使用方法

使用 uv 运行服务：

uv run 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：搜索结果的相关性评分

错误处理

如果搜索操作期间发生错误，该工具会返回描述问题的错误消息。