Overview
What is Weather MCP Server?
A Model Context Protocol (MCP) server that provides real‑time weather information using the OpenWeatherMap API. It delivers detailed weather data (temperature, humidity, wind speed, sunrise/sunset times, and description) in metric units. Designed for integration with MCP‑compatible clients like Claude Desktop.
How to use Weather MCP Server?
Install via Smithery with npx -y @smithery/cli install @CodeByWaqas/weather-mcp-server --client claude or manually by cloning the repository, creating a virtual environment, and running pip install -e .. Configure your OpenWeatherMap API key in an .env file. Then launch Claude Desktop; the server will be automatically invoked by the client to fetch weather data on request.
Key features of Weather MCP Server
- Real‑time weather data using OpenWeatherMap API
- Metric units for temperature and wind speed
- Temperature, humidity, and wind speed reporting
- Sunrise and sunset time information
- Human‑readable weather description
Use cases of Weather MCP Server
- Ask an AI assistant for current weather in any city
- Integrate weather lookups into automated workflow scripts
- Get detailed weather conditions through a natural‑language interface
FAQ from Weather MCP Server
What weather data does it provide?
Temperature (metric), humidity percentage, wind speed, sunrise/sunset times, and a general weather description (e.g., “clear sky”).
What are the prerequisites?
Python 3.12 or higher and a free OpenWeatherMap API key.
How do I install it?
Either via Smithery (npx command) or manually by cloning the repo, creating a virtual environment, and installing dependencies with pip install -e . (or uv add for development).
How do I configure the API key?
Copy src/resources/env.example to src/resources/.env and set WEATHER_API_KEY=your_api_key_here.
How do I use it with Claude Desktop?
Add the server configuration to Claude’s claude_desktop_config.json (using uv as the command) and set the WEATHER_API_KEY environment variable. Then ask Claude for weather information.
