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：访问服务器端点的密钥。
• TAVILY_API_KEY：访问 Tavily API 的密钥。

在运行服务器之前，请将这两个密钥设置为环境变量。

端点

/tavily-search

使用 Tavily API 执行搜索。

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

/tavily-extract

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

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