devilcoder01/weather-mcp-server
🐍 ☁️ - Access real-time weather data for any location using the WeatherAPI.com API, providing detailed forecasts and current conditions.
Quick Install
{
"mcpServers": {
"devilcoder01-weather-mcp-server": {
"command": "npx",
"args": [
"-y",
"devilcoder01-weather-mcp-server"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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_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.