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_KEY:用于访问服务器端点的密钥。TAVILY_API_KEY:用于访问 Tavily API 的密钥。在运行服务器之前,请将这两个密钥设置为环境变量。
/tavily-search使用 Tavily API 执行搜索。
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。
TavilyExtractRequest
urls (list[str]):要提取内容的 URL 列表。extract_depth (Literal["basic", "advanced"], 可选):提取的深度,默认为 "basic"。include_images (bool, 可选):是否包含图像在提取中,默认为 False。TavilyResponse