Region Weather retrieves comprehensive weather information for any global location through the wttr.in API service, delivering current conditions, forecasts, and atmospheric metrics via standardized MCP interfaces without requiring API keys. Key features of Region Weather: - Real-time weather conditions, 3-day hourly forecasts, astronomical data (sunrise, sunset, moon phases), and environmental measurements (humidity, barometric pressure, wind speed, UV index, visibility) - Integration with the free wttr.in weather service—no API key or registration required - Flexible transport modes: HTTP server on port 8081 for web clients or stdio for local MCP integrations - Lightweight Python 3.10+ implementation using FastMCP with minimal dependencies (requests, fastmcp) and Docker deployment support

Weather MCP Server

A Model Context Protocol (MCP) server that provides weather information for different regions around the world.

Overview

This MCP server uses the wttr.in API to fetch weather data and serves it through a standardized MCP interface. It allows AI models and other clients to request weather information for any region by name.

Features

Requirements

Installation

1. Clone the repository:

   git clone https://github.com/hydavinci/weather_mcp.git
   cd weather_mcp
   

2. Install dependencies using uv (recommended):

   uv sync
   

Or using pip:

   pip install requests fastmcp
   

Usage

Running the server locally

HTTP mode (recommended for web clients):

# PowerShell
$env:TRANSPORT="http"; python src/server.py
Bash/Linux
TRANSPORT=http python src/server.py

stdio mode (for local MCP clients):

python src/server.py

The server will start on port 8081 by default for HTTP mode.

Using Docker

Build the Docker image:

docker build -t weather-mcp-server .

Run the container:

docker run -p 8081:8081 weather-mcp-server

API Usage

The server exposes a single MCP tool:

get_weather

Fetches weather information for the specified region.

Parameters:

Returns:

Example weather data includes:

Testing

You can test the weather functionality directly by running:

python src/weather_fetcher.py

This will fetch and display weather information for Suzhou (default city).

Environment Variables

Project Structure

weather_mcp/
├── src/
│   ├── server.py           # Main MCP server
│   ├── weather_fetcher.py  # Weather API client
│   └── middleware.py       # HTTP middleware
├── pyproject.toml          # Project configuration
├── Dockerfile             # Container configuration
├── smithery.yaml          # Smithery deployment config
└── README.md              # This file

License

See the LICENSE file for details.

Build the Docker image:

docker build -t weather-mcp-server .

Run the container:

docker run -p 8000:8000 weather-mcp-server

API Usage

The server exposes a single MCP handler:

get_weather

Fetches weather information for the specified region.

Parameters:

Returns:

Example:

# Example client code
from mcp.client import MCPClient
async with MCPClient("http://localhost:8000") as client:
    weather_data = await client.get_weather(region_name="London")
    print(weather_data)

Testing

You can test the weather functionality directly by running:

python weather_fetcher.py

This will fetch and display weather information for Suzhou (default city).

License

See the LICENSE file for details.