Tavily Search MCP Server

An MCP server implementation that integrates the Tavily Search API, providing optimized search capabilities for LLMs.

Features

• Web Search: Perform web searches optimized for LLMs, with control over search depth, topic, and time range.
• Content Extraction: Extracts the most relevant content from search results, optimizing for quality and size.
• Optional Features: Include images, image descriptions, short LLM-generated answers, and raw HTML content.
• Domain Filtering: Include or exclude specific domains in search results.

Tools

• tavily_search
  • Execute web searches using the Tavily Search API.
  • Inputs:
    • query (string, required): The search query.
    • search_depth (string, optional): “basic” or “advanced” (default: “basic”).
    • topic (string, optional): “general” or “news” (default: “general”).
    • days (number, optional): Number of days back for news search (default: 3).
    • time_range (string, optional): Time range filter (“day”, “week”, “month”, “year” or “d”, “w”, “m”, “y”).
    • max_results (number, optional): Maximum number of results (default: 5).
    • include_images (boolean, optional): Include related images (default: false).
    • include_image_descriptions (boolean, optional): Include descriptions for images (default: false).
    • include_answer (boolean, optional): Include a short LLM-generated answer (default: false).
    • include_raw_content (boolean, optional): Include raw HTML content (default: false).
    • include_domains (string[], optional): Domains to include.
    • exclude_domains (string[], optional): Domains to exclude.

Setup Guide 🚀

1. Prerequisites

• Claude Desktop installed on your computer.
• A Tavily API key: a. Sign up for a Tavily API account. b. Choose a plan (Free tier available). c. Generate your API key from the Tavily dashboard.

2. Installation

1. Clone this repository somewhere on your computer:

   git clone https://github.com/apappascs/tavily-search-mcp-server.git 
   

2. Install dependencies & build the project:

   cd tavily-search-mcp-server
   

   npm install
   

   npm run build
   

3. Integration with Claude Desktop

1. Open your Claude Desktop configuration file:

   # On Mac:
   ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # On Windows:
   %APPDATA%\Claude\claude_desktop_config.json