mcp_weather

mcp_weather

Get weather information from https://api.open-meteo.com API.

29
Stars
24
Forks
5
Releases

Overview

Weather MCP Server is a Model Context Protocol server that provides weather, air quality, and time utilities by consuming data from the Open-Meteo API. It exposes rich current-weather data with metrics such as temperature, humidity, dew point, wind speed/direction/gusts, precipitation, atmospheric pressure, cloud cover, UV index, visibility, and a 'feels like' temperature, and it can also fetch weather for a specified date range with hourly detail. It also returns air quality data for multiple pollutants (PM2.5/PM10, O3, NO2, CO, SO2, ammonia, dust) and related health advisories. Time tools include getting the current date/time in any timezone, converting times between zones, and obtaining timezone information. The server supports three transport modes in one binary: stdio for desktop MCP clients, SSE for web apps (with /sse and /messages/), and streamable-http for modern web usage (single /mcp endpoint). It runs without an API key and uses free Open-Meteo data sources. RESTful endpoints are available via Starlette integration. Docker deployment is supported, and the codebase is organized for easy tool extension.

Details

Owner
isdaniel
Language
Python
License
Apache License 2.0
Updated
2025-12-07

Features

Weather and Air Quality Data

Get current weather metrics and hourly data for a date range, plus comprehensive air quality measurements (PM2.5/PM10, O3, NO2, CO, SO2, dust) and health advisories.

Time and Timezone Utilities

Obtain current date/time in any timezone, convert times between zones, and fetch timezone information.

Multiple Transport Modes

Run a single unified server supporting stdio, SSE, and streamable-http transport modes for desktop, web, and API clients.

Streamable MCP HTTP Protocol Support

Implements MCP Streamable HTTP with a single /mcp endpoint; supports stateful and stateless modes.

SSE Endpoints and Messaging

Provides SSE-based MCP communication via /sse and a messaging endpoint at /messages/ for requests.

RESTful API Endpoints via Starlette

Offers REST-like endpoints through Starlette integration for web tooling and testing.

Open-Meteo Data Source (No API Key)

Uses free, open Open-Meteo data sources without requiring an API key.

Docker & Deployment Support

Includes Docker images, quick-start commands, and build options for SSE and streamable-http modes.

Audience

MCP clientsDesktop and CLI MCP clients fetch weather, air quality, and time data.
Web developersWeb apps integrate weather data via SSE or streamable HTTP.
Time/Weather appsApplications needing time and weather data across timezones.

Tags

weatherair_qualitytimetimezoneMCPOpen-MeteoSSEstreamable-httpstdioStarlette