Skip to main content
Glama

weather-mcp 🌤

An MCP (Model Context Protocol) server that provides weather data — current conditions and forecasts — to AI agents.

what an MCP Server?

An MCP server is just a Python program that:
1. Starts a server.
2. Registers one or more tools.
3. Waits for a client (Cline) to call those tools.
4. Executes the requested tool.
5. Returns the result.

Architecture

weather-mcp/
├── src/
│   ├── server.py              # MCP server entry point
│   ├── config.py              # Config/constants
│   ├── logger.py              # Logging
│   ├── tools/weather.py       # MCP tool definitions
│   ├── services/weather_service.py  # Business logic
│   ├── clients/weather_client.py    # OpenWeatherMap API client
│   ├── models/weather_model.py      # Data models
│   └── utils/helpers.py             # Utility functions
└── tests/test_weather.py

Related MCP server: Python Weather MCP Server

Prerequisites

Setup

# Clone and enter the directory
cd weather-mcp

# Create a virtual environment
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Configure your API key
cp .env.example .env
# Edit .env and set WEATHER_API_KEY=your_key

Usage

Run the MCP server (stdio mode)

python -m src.server

Or using the MCP CLI:

mcp run src/server.py

Available Tools

Tool

Description

get_current_weather

Current conditions by city or GPS coordinates

get_forecast

3-hourly forecast by city or GPS coordinates

Both tools accept units (metric, imperial, or standard).

Testing

pytest tests/

Output format

Here's the current weather for Mumbai fetched live from the weather-mcp server:


☁️ Mumbai, IN — Broken Clouds

Metric

Value

🌡 Temperature

30.1°C (feels like 35.5°C)

📊 Min / Max

30.1°C / 30.1°C

💧 Humidity

71%

🌬 Wind

4.4 m/s at 255° (WSW)

👁 Visibility

10,000 m

☁️ Cloud Cover

82%

🔽 Pressure

1006 hPa


Notice the feels-like temperature (35.5°C) is noticeably higher than the actual 30.1°C — this is due to the high humidity (71%) making it feel much hotter, which is typical for Mumbai's coastal climate.

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kaustubhreet/weather-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server