tavily-mcp-sse

tavily-mcp-sse

0
research_and_data

Tavily MCP Server is a FastAPI application designed to provide an interface for interacting with the Tavily API, featuring search and extraction functionalities. It offers detailed options for customized searches and content extraction via POST requests.

Tavily MCP Server

Basic FastAPI-based server application that provides endpoints for interacting with the Tavily API. The server includes API key authentication and uses the fastapi-mcp library to create a remote SSE MCP server out of it.

Installation

To install the project's dependencies, run the following command:

pip install -r requirements.txt

Usage

To run the server, use the following command:

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

The server will be available at http://127.0.0.1:8000.

API Key

The server requires two API keys:

  • API_KEY: The API key for accessing the server's endpoints.
  • TAVILY_API_KEY: The API key for accessing the Tavily API.

Set these API keys as environment variables before running the server.

Endpoints

/tavily-search

Perform a search using the Tavily API.

  • Method: POST
  • Request Body: TavilySearchRequest
    • query (str): The search query.
    • search_depth (Literal["basic", "advanced"], optional): The depth of the search. Defaults to "basic".
    • topic (Literal["general", "news"], optional): The topic of the search. Defaults to "general".
    • days (int, optional): The number of days to search. Defaults to 3.
    • time_range (Literal["day", "week", "month", "year", "d", "w", "m", "y"], optional): The time range of the search. Defaults to "day".
    • max_results (int, optional): The maximum number of results to return. Defaults to 10.
    • include_images (bool, optional): Whether to include images in the results. Defaults to False.
    • include_image_descriptions (bool, optional): Whether to include image descriptions in the results. Defaults to False.
    • include_raw_content (bool, optional): Whether to include raw content in the results. Defaults to False.
    • include_domains (list[str], optional): A list of domains to include in the search. Defaults to an empty list.
    • exclude_domains (list[str], optional): A list of domains to exclude from the search. Defaults to an empty list.
  • Response: TavilyResponse

/tavily-extract

Extract content from URLs using the Tavily API.

  • Method: POST
  • Request Body: TavilyExtractRequest
    • urls (list[str]): A list of URLs to extract content from.
    • extract_depth (Literal["basic", "advanced"], optional): The depth of the extraction. Defaults to "basic".
    • include_images (bool, optional): Whether to include images in the extraction. Defaults to False.
  • Response: TavilyResponse