Weather MCP Server

This project is a Model Context Protocol (MCP) server that provides weather data and alerts using the National Weather Service (NWS) API. It exposes tools for retrieving active weather alerts for a US state and weather forecasts for a given latitude and longitude.

Features

Get active weather alerts for any US state
Get weather forecast for a specific location (latitude/longitude)
MCP server implementation using @modelcontextprotocol/sdk

Usage

Prerequisites

Node.js (v18 or higher recommended)
npm or yarn

Install dependencies

npm install

Run the server

npm start

API Tools

`get_alerts`

Get active weather alerts for a US state.

Input: state (string, two-letter code, e.g. "CA", "NY")
Output: List of active alerts or a message if none are active.

`get_forecast`

Get weather forecast for a location.

Input: latitude (number), longitude (number)
Output: Forecast periods for the location.

Project Structure

weather/ ├── src/ │ ├── index.ts # MCP server implementation │ └── helper.ts # Helper functions and types ├── build/ # Compiled JS output ├── package.json # Project metadata and dependencies ├── tsconfig.json # TypeScript configuration