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

License

MIT