Skip to main content
Glama
IamKavy47

Tavily Web Search MCP Server

by IamKavy47
README.md
# MCP Server

This repository is a work in progress. It is not finished yet, so use it on your own risk and expect rough edges.

## What it is

This project contains an MCP server prototype with a Tavily-powered web search tool.

Current code lives in:

- `src/config.py` for environment loading and API key setup
- `src/tools/web_search.py` for the web search MCP tool

## Requirements

- Python 3.10+
- A valid `TAVILY_API_KEY`

## Setup

Install dependencies with your preferred Python environment manager, then set the API key:

```bash
export TAVILY_API_KEY="your_key_here"
```

If you use a `.env` file, the project loads it through `python-dotenv`.

## Run

The module currently runs successfully with:

```bash
uv run python -m src.tools.web_search
```

Direct execution with `python src/tools/web_search.py` is not the supported path right now.

## Status

This is still in progress.

- The web search tool is experimental.
- The code is not production-ready.
- Use it carefully and test before relying on it.