foohm71/simplemcp

AI Makerspace: MCP Event - Enhanced Weather Tools

This project is a fork of the original AI Makerspace MCP Event repository, enhanced with additional weather functionality. The original project demonstrated the MCP (Model Context Protocol) server using the Tavily API for web search capabilities.

🆕 New Features Added

This fork extends the original MCP server with two new weather tools:

• get_current_weather: Retrieves current weather conditions for any city using the RapidAPI Weather API
• get_forecast_weather: Provides detailed weather forecasts for up to 14 days for any city

Weather Tools Usage

The weather tools can be used to get real-time weather data and forecasts:

# Get current weather for a city
get_current_weather(city="London")

# Get weather forecast for a city (1-14 days)
get_forecast_weather(city="Paris", num_days=3)

Project Overview

The MCP server is set up to handle web search queries using the Tavily API and weather data using the RapidAPI Weather API. It is built with the following key components:

• TavilyClient: A client for interacting with the Tavily API to perform web searches
• Weather API Integration: Direct integration with RapidAPI Weather API for current conditions and forecasts
• Dice Rolling: A custom dice rolling tool for tabletop gaming scenarios

Prerequisites

• Python 3.13 or higher
• A valid Tavily API key
• A valid RapidAPI key (for weather functionality)

⚠️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:

git clone https://github.com/AI-Maker-Space/MCP-Session-Code.git

After that, you can follow from Step 2. below!

Installation

1. Clone the repository:

   git clone <repository-url>
   cd <repository-directory>
   

2. Configure environment variables: Copy the .env.sample to .env and add your API keys:

   TAVILY_API_KEY=your_tavily_api_key_here
   RAPIDAPI_KEY=your_rapidapi_key_here
   

3. 🏗️ 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.

{
    "mcpServers":  {
        "mcp-server": {
            "command" : "uv",
            "args" : ["--directory", "/PATH/TO/REPOSITORY", "run", "server.py"]
        }
    }
}

The server will start and listen for commands via standard input/output.

Usage

The server provides several tools:

• web_search: Search the web for information about a given query using Tavily API
• get_current_weather: Get current weather conditions for any city
• get_forecast_weather: Get weather forecasts for any city (1-14 days)
• roll_dice: Roll dice with custom notation (e.g., "2d20+5")

Original Project Credits

This project is based on the original AI Makerspace MCP Event repository by the AI Makerspace team. The original project demonstrated MCP server implementation with web search capabilities.

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.