Tavily MCP Server with Proxy Support

A Model Context Protocol server that provides AI-powered web search capabilities using Tavily's search API, with added support for HTTP/HTTPS proxy configurations. This server enables LLMs to perform sophisticated web searches through proxy servers, get direct answers to questions, and search recent news articles with AI-extracted relevant content.

Features

• All original Tavily MCP Server features

• HTTP/HTTPS proxy support through environment variables

• Enhanced logging for proxy configurations

• Robust error handling for proxy-related issues

Available Tools

• tavily_web_search - Performs comprehensive web searches with AI-powered content extraction.

  • query (string, required): Search query

  • max_results (integer, optional): Maximum number of results to return (default: 5, max: 20)

  • search_depth (string, optional): Either "basic" or "advanced" search depth (default: "basic")

• tavily_answer_search - Performs web searches and generates direct answers with supporting evidence.

  • query (string, required): Search query

  • max_results (integer, optional): Maximum number of results to return (default: 5, max: 20)

  • search_depth (string, optional): Either "basic" or "advanced" search depth (default: "advanced")

• tavily_news_search - Searches recent news articles with publication dates.

  • query (string, required): Search query

  • max_results (integer, optional): Maximum number of results to return (default: 5, max: 20)

  • days (integer, optional): Number of days back to search (default: 3)

Installation

Use pip

or if you have uv installed:

Build from Source

Clone this repository and build and install the program:

Configuration

API Key and Proxy Settings

The server requires a Tavily API key and supports proxy configuration through environment variables:

1. Set required environment variables:

2. Or provide API key as a command-line argument:

Configure for Claude.app

Add to your Claude settings:

Examples

For a regular search:

To generate a report with explicit exclusions:

For news search:

Debugging

Enable debug logging to see detailed proxy configuration information:

You can also use the MCP inspector:

Contributing

Contributions are welcome! Please feel free to submit pull requests to help improve the proxy support or add new features.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This project is based on the original mcp-tavily with added proxy support functionality.