LABSCO SUMMARY

One job, one key, metric only.

There is no unit switch and no forecast horizon to configure — it returns current conditions in metric, which is either exactly what you wanted or a conversion away. The one decision is where the key lives: the client env block keeps it out of the repository, the .env file is easier when several things share it.

What it is

A small weather server backed by the OpenWeatherMap API. Ask about a location and it returns the live reading rather than a forecast page: temperature, humidity, wind speed, sunrise and sunset times, and the conditions description.

What you get

Real-time weather for a location, returned as structured fields
Temperature in metric units — no unit argument to remember
Humidity and wind speed alongside it
Sunrise and sunset times for the location
The weather description in words, so an assistant can quote it directly

Requirements

Python 3.12 or higher and a free OpenWeatherMap API key. Published as weather-mcp-server version 0.1.0. Clone the repo, create a virtual environment, pip install -e ., then register uv with --directory pointing at src/resources, followed by run and server.py, with WEATHER_API_KEY in the entry's env. The key can also live in src/resources/.env.

Setup effort

Add the configuration to your client

See installation options

USE CASES

01

Checking conditions somewhere before you decide something

Ask for the weather at a city and get temperature, wind and description in one answer.

02

Working out how much daylight is left

Read the sunrise and sunset times for the location without opening a separate site.

03

Giving an agent real weather instead of a guess

Ground a scheduling or travel suggestion in the live reading rather than the model's assumptions.

BEFORE YOU INSTALL

What to know first

Requires

uv on PATH
Python 3.12 or later
WEATHER_API_KEY in your environment

INSTALLATION

Connect your client

MCP Clients

Claude Desktop

Clone it and install it

Run it from a local copy (Python 3.12 or later, and uv for the client entry).

CLAUDE DESKTOP · TERMINAL

git clone https://github.com/CodeByWaqas/weather-mcp-server
cd weather-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e .

Add to claude_desktop_config.json

/<YOUR_ABSOLUTE_PATH> is the absolute path of the folder that holds your weather-mcp-server clone, and <YOUR_WEATHER_API_KEY> is your OpenWeatherMap API key.

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "mcp-weather-project": {
      "command": "uv",
      "args": [
        "--directory",
        "/<YOUR_ABSOLUTE_PATH>/weather-mcp-server/src/resources",
        "run",
        "server.py"
      ],
      "env": {
        "WEATHER_API_KEY": "<YOUR_WEATHER_API_KEY>"
      }
    }
  }
}

OpenWeatherMap Weather MCP Server