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