About Victor Weather
Victor Weather is a FastAPI-based MCP server for AI assistants that need weather and related data. It covers current conditions, forecasts, historical records, alerts, air quality, and location-related information.
Key features
- 01Current conditions and forecasts
- 02Historical weather and alerts
- 03Air quality information
- 04Sunrise, sunset, and moon phases
- 05Location search and timezone data
- 06Sports event information
Use cases
- 01Check current weather and upcoming forecasts
- 02Review air quality and weather alerts
- 03Find sunrise or timezone information for a location
MCP support
Exposes weather, air quality, astronomy, location, timezone, and sports-event data through MCP tools. A WeatherAPI key is required.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEWeather 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_server -
Install 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.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.