mcpField
T
Tavily MCP Server

Tavily MCP Server

本地服务
github.com/NoeSamaille搜索与检索279 周前更新

关于 Tavily MCP Server

Tavily MCP Server 通过基于 FastAPI 的远程 SSE 服务提供 Tavily 搜索和 URL 内容提取,适用于需要网页检索的 MCP 客户端,并以 API 密钥进行访问控制。

主要功能

  1. 01按深度和主题进行 Tavily 搜索
  2. 02按时间与域名筛选结果
  3. 03可选返回图片和原始内容
  4. 04提取 URL 内容

适用场景

  1. 01搜索一般主题或新闻
  2. 02按时间范围或域名筛选结果
  3. 03提取指定 URL 的内容

MCP 相关

项目使用 fastapi-mcp 将 Tavily API 端点提供为远程 SSE MCP 服务,供 MCP 客户端调用。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Tavily MCP 服务

基于 FastAPI 的基础服务应用,提供用于与 Tavily API 交互的端点。该服务包含 API 密钥身份验证,并使用 fastapi-mcp 库将其转换为远程 SSE MCP 服务。

安装

若要安装项目依赖项,请运行以下命令:

pip install -r requirements.txt

用法

若要运行服务,请使用以下命令:

uvicorn server:app --host 0.0.0.0 --port 8000 --reload

服务将在 http://127.0.0.1:8000 上提供。

API 密钥

该服务需要两个 API 密钥:

  • API_KEY:用于访问服务端点的 API 密钥。
  • TAVILY_API_KEY:用于访问 Tavily API 的 API 密钥。

运行服务前,请将这些 API 密钥设置为环境变量。

端点

/tavily-search

使用 Tavily API 执行搜索。

  • 方法:POST
  • 请求正文:TavilySearchRequest
    • query (str):搜索查询。
    • search_depth (Literal["basic", "advanced"], optional):搜索深度。默认为 "basic"。
    • topic (Literal["general", "news"], optional):搜索主题。默认为 "general"。
    • days (int, optional):搜索的天数。默认为 3。
    • time_range (Literal["day", "week", "month", "year", "d", "w", "m", "y"], optional):搜索的时间范围。默认为 "day"。
    • max_results (int, optional):返回结果的最大数量。默认为 10。
    • include_images (bool, optional):是否在结果中包含图片。默认为 False。
    • include_image_descriptions (bool, optional):是否在结果中包含图片描述。默认为 False。
    • include_raw_content (bool, optional):是否在结果中包含原始内容。默认为 False。
    • include_domains (list[str], optional):要纳入搜索的域名列表。默认为空列表。
    • exclude_domains (list[str], optional):要从搜索中排除的域名列表。默认为空列表。
  • 响应:TavilyResponse
/tavily-extract

使用 Tavily API 从 URL 中提取内容。

  • 方法:POST
  • 请求正文:TavilyExtractRequest
    • urls (list[str]):要从中提取内容的 URL 列表。
    • extract_depth (Literal["basic", "advanced"], optional):提取深度。默认为 "basic"。
    • include_images (bool, optional):是否在提取内容中包含图片。默认为 False。
  • 响应:TavilyResponse

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。