Weather MCP Server

A Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API. This server offers tools to fetch weather alerts and forecasts for locations in the United States.

Features

• Get active weather alerts for any US state
• Fetch detailed weather forecasts for specific coordinates
• Built using FastMCP for efficient API communication
• Asynchronous HTTP requests using httpx
• Clean and formatted output for weather information

Prerequisites

• Python 3.12 or higher
• uv package manager (recommended for installation)

Installation

1. Clone the repository:

git clone <repository-url>
cd weather

2. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

3. Install dependencies using uv:

uv pip install -e .

Usage

The server provides two main tools:

1. Get Weather Alerts

get_alerts(state: str) -> str

Fetches active weather alerts for a specified US state using its two-letter code (e.g., "CA" for California).

2. Get Weather Forecast

get_forecast(latitude: float, longitude: float) -> str

Retrieves a detailed weather forecast for a specific location using its latitude and longitude coordinates.

Running the Server

To start the MCP server:

uv run weather.py

Dependencies

• httpx >= 0.28.1: For making HTTP requests
• mcp[cli] >= 1.9.2: For MCP server functionality