Weather MCP Server

smithery badge

Overview

This repository contains an MCP (Model Context Protocol) server for accessing US weather data from the National Weather Service (NWS) API. The server provides tools to fetch weather alerts and forecasts for locations across the United States.

Features

Get weather alerts for any US state using two-letter state codes
Retrieve detailed weather forecasts by latitude and longitude
Structured logging with contextual information
Error handling and timeout management

Installation

Installing via Smithery

To install mcp-weather-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @asifdotpy/mcp-weather-server --client claude

Manual Installation

# Clone the repository
git clone <repository-url>

# Navigate to the directory
cd weather

# Install dependencies (requires Python 3.11+)
pip install -e .

Dependencies

httpx: For making asynchronous HTTP requests
mcp: Model Context Protocol library for building MCP servers

Usage

The server provides two main tools:

Get Weather Alerts

get_alerts(state: str) -> str

state: Two-letter US state code (e.g., CA, NY)
Returns formatted weather alerts for the specified state

Get Weather Forecast

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

latitude: Latitude of the location
longitude: Longitude of the location
Returns a 5-period weather forecast for the specified coordinates

Running the Server

python weather.py

The server runs over stdio, making it compatible with MCP clients.

Development

Set the ENV environment variable to "production" for JSON-formatted logs
Configure logging level with the LOG_LEVEL environment variable

License

[Specify your license here]