Weather Forecast MCP Server

An MCP (Model Context Protocol) server that provides 3-day weather forecasts for any location using the WeatherAPI service. Weather data is automatically saved to files in the data directory for future reference.

Features

• Get 3-day weather forecasts for any location (postal code, zip code, or city name)
• Current weather conditions including temperature, humidity, wind speed, and feels-like temperature
• Detailed daily forecasts with:
  • Min/max/average temperatures (Celsius and Fahrenheit)
  • Weather conditions
  • Wind speeds
  • Humidity levels
  • Chance of rain and snow
  • Sunrise and sunset times
• Automatic data persistence to JSON files
• Retrieve previously saved weather data
• Status tracking for all saved locations

Setup

1. Get a WeatherAPI Key

1. Visit WeatherAPI.com
2. Sign up for a free account
3. Get your API key from the dashboard

2. Configure Environment

Create or update the .env file with your API key:

WEATHER_API=your_api_key_here

3. Install Dependencies

Using uv (recommended):

uv sync

Or using pip:

pip install -e .