Skip to main content
Glama
kaustubhreet

weather-mcp

by kaustubhreet
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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: OpenWeather-OneCall3-MCP

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-weather

    githubmilind
    F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that enables AI assistants and LLMs to access real-time weather data and forecasts by connecting to the OpenWeatherMap API.
    -

  • OpenWeather-OneCall3-MCP

    Hakuin123
    F
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides weather data using the OpenWeather One Call API 3.0. This server allows AI agents to access current weather, forecasts, and historical weather data for any location.
    3
    5 npm
    -

  • mcp-open-meteo

    pipeworx-io
    A
    license
    Not graded
    quality
    B
    maintenance
    This MCP server provides access to Open-Meteo weather APIs including forecast, historical reanalysis, geocoding, air quality, marine weather, and flood risk data, enabling AI agents to retrieve weather information using natural language.
    7 npm
    MIT