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

1. Clone this repository:

   git clone https://github.com/yourusername/Weather_mcp_server.git
   cd Weather_mcp_server

2. Install dependencies using uv:

   uv venv
   uv pip install -e .

3. Create a .env file 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.