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