Loads environment variables from a .env file to securely configure the server with API keys.
Used for version control and repository management, enabling users to clone the project code.
Hosts the repository and provides access to the project code through cloning.
The runtime environment required to execute the MCP server, version 3.13 or higher is needed.
AI Makerspace: MCP Event
This project is a demonstration of the MCP (Model Context Protocol) server, which utilizes the Tavily API for web search capabilities. The server is designed to run in a standard input/output (stdio) transport mode.
Project Overview
The MCP server is set up to handle web search queries using the Tavily API. It is built with the following key components:
- TavilyClient: A client for interacting with the Tavily API to perform web searches.
Prerequisites
- Python 3.13 or higher
- A valid Tavily API key
⚠️NOTE FOR WINDOWS:⚠️
You'll need to install this on the Windows side of your OS.
This will require getting two CLI tool for Powershell, which you can do as follows:
winget install astral-sh.uv
winget install --id Git.Git -e --source winget
After you have those CLI tools, please open Cursor into Windows.
Then, you can clone the repository using the following command in your Cursor terminal:
After that, you can follow from Step 2. below!
Installation
- Clone the repository:
- Configure environment variables:
Copy the
.env.sample
to.env
and add your Tavily API key: - 🏗️ Add a new tool to your MCP Server 🏗️
Create a new tool in the server.py
file, that's it!
Running the MCP Server
To start the MCP server, you will need to add the following to your MCP Profile in Cursor:
NOTE: To get to your MCP config. you can use the Command Pallete (CMD/CTRL+SHIFT+P) and select "View: Open MCP Settings" and replace the contents with the JSON blob below.
The server will start and listen for commands via standard input/output.
Usage
The server provides a web_search
tool that can be used to search the web for information about a given query. This is achieved by calling the web_search
function with the desired query string.
License
This project is licensed under the MIT License. See the LICENSE file for more details.
Contributing
Contributions are welcome! Please open an issue or submit a pull request for any changes.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables web search capabilities using the Tavily API, allowing AI models to retrieve current information from the internet through natural language commands.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server enabling advanced search and content extraction using the Tavily API, with rich customization and integration options.Last updated -45746JavaScriptMIT License
- AsecurityFlicenseAqualityAn MCP protocol server that enables web search functionality using the Tavily API, allowing AI assistants to perform internet searches in real-time.Last updated -42Python
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.Last updated -161614JavaScript
- -securityAlicense-qualityA Model Context Protocol server that performs comprehensive web research by combining Tavily Search and Crawl APIs to gather extensive information and provide structured JSON output tailored for LLMs to create detailed markdown documents.Last updated -1415JavaScriptMIT License