Access Comprehensive Weather Data
Weather MCP Server gives AI assistants current conditions, 14-day forecasts, air quality, astronomy, and weather alerts.
Why it matters
Integrate a robust weather data service into your applications. This MCP server provides access to current conditions, forecasts, historical data, air quality, and astronomical information via WeatherAPI.
Outcomes
What it gets done
Retrieve current weather conditions and forecasts (1-14 days).
Access historical weather data and air quality information.
Obtain astronomical data like sunrise, sunset, and moon phases.
Search for weather data by location and retrieve timezone details.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-weather-mcp-server | bash Capabilities
Tools your agent gets
Retrieve current weather conditions for a specified location
Get weather forecast data for 1-14 days ahead
Retrieve historical weather data for a location
Fetch active weather alerts for a specified location
Get air quality information and pollution data
Retrieve sunrise, sunset, and moon phase information
Search for locations and get geographic information
Get timezone information for a specified location
Retrieve sports events data for a location
Overview
weather-mcp-server MCP Server
Weather MCP Server connects an AI assistant to WeatherAPI, providing current conditions, multi-day forecasts, historical data, alerts, air quality, and astronomy information for any location. Use it whenever an assistant needs real weather data - forecasts, alerts, air quality, or astronomy details; requires a WeatherAPI account and key.
What it does
Weather MCP Server is a FastAPI-based Model Context Protocol server that gives AI assistants access to weather data via the WeatherAPI service. It covers current conditions, forecasts up to 14 days out, historical weather, active weather alerts, air quality, astronomy data like sunrise/sunset and moon phases, location search, timezone information, and sports event data.
When to use - and when NOT to
Use this when you want an assistant to answer weather-related questions with real data - checking today's conditions, planning around a multi-day forecast, looking up air quality, or finding sunrise/sunset times for a location. It's a straightforward weather-data lookup layer. It is not useful without a WeatherAPI account and API key, and it depends entirely on WeatherAPI's coverage and accuracy for the data it returns.
Capabilities
- Current weather conditions for a location.
- Weather forecasts spanning 1-14 days.
- Historical weather data lookups.
- Active weather alerts for a location.
- Air quality information.
- Astronomy data: sunrise, sunset, and moon phases.
- Location search and timezone information.
- Sports events data.
How to install
Install via Smithery for Claude Desktop:
npx -y @smithery/cli install @devilcoder01/weather-mcp-server --client claude
Or install manually:
git clone https://github.com/yourusername/Weather_mcp_server.git
cd Weather_mcp_server
uv venv
uv pip install -e .
Create a .env file with your WeatherAPI key: WEATHER_API_KEY=your_api_key_here. Then run the server with python main.py; it starts on http://localhost:8000 by default. Requires Python 3.13+ and the uv package manager.
Who it's for
Anyone building a weather-aware assistant or app who wants current conditions, forecasts, alerts, and related data (air quality, astronomy, timezone) available directly to an AI assistant without a separate API integration.
Source README
Weather MCP Server
A Model Context Protocol (MCP) server for weather data, built with FastAPI and the MCP framework. This server provides various weather-related tools that can be used by AI assistants to retrieve current weather conditions, forecasts, air quality data, and more.
Features
- Current weather conditions
- Weather forecasts (1-14 days)
- Historical weather data
- Weather alerts
- Air quality information
- Astronomy data (sunrise, sunset, moon phases)
- Location search
- Timezone information
- Sports events
Requirements
- Python 3.13+
- uv package manager
- WeatherAPI API key
Installation
Installing via Smithery
To install Weather Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @devilcoder01/weather-mcp-server --client claude
Manual Installation
Clone this repository:
git clone https://github.com/yourusername/Weather_mcp_server.git cd Weather_mcp_serverInstall dependencies using uv:
uv venv uv pip install -e .Create a
.envfile in the project root with your WeatherAPI key:WEATHER_API_KEY=your_api_key_here
Usage
Run the server:
python main.py
The server will start on http://localhost:8000 by default.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.