A simple minimal weather mcp server :)
17 stars
Python
Updated Oct 5, 2025
mcp-server
weather-api
weather-mcp-server
Documentation
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:
bash
npx -y @smithery/cli install @devilcoder01/weather-mcp-server --client claudeManual Installation
1. Clone this repository:
code
git clone https://github.com/yourusername/Weather_mcp_server.git
cd Weather_mcp_server2. Install dependencies using uv:
code
uv venv
uv pip install -e .3. Create a .env file in the project root with your WeatherAPI key:
code
WEATHER_API_KEY=your_api_key_hereUsage
Run the server:
code
python main.pyThe server will start on http://localhost:8000 by default.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Similar MCP
Based on tags & features
Trending MCP
Most active this week