Weather MCP Server
A Model Context Protocol (MCP) server that provides weather information services using the National Weather Service (NWS) API. This server implements a set of tools that can be used by AI models to fetch weather alerts and forecasts for locations in the United States.
Features
- Weather Alerts: Get active weather alerts for any US state using a two-letter state code
- Weather Forecast: Get detailed weather forecasts for any location in the US using latitude and longitude coordinates
- MCP Integration: Implements the Model Context Protocol for seamless integration with AI models
- TypeScript: Written in TypeScript for type safety and better developer experience
Installation
npm install
npm run build
Usage
This server is designed to be used as a CLI tool and can be installed globally:
npm install -g .
weather
The server runs on stdio and provides two main tools:
1. Get Weather Alerts
Retrieves active weather alerts for a specified US state.
Example parameters:
{
"state": "CA" // Two-letter state code
}
2. Get Weather Forecast
Retrieves weather forecast for a specific location using coordinates.
Example parameters:
{
"latitude": 37.7749,
"longitude": -122.4194
}
Technical Details
- Built using the
@modelcontextprotocol/sdkfor MCP implementation - Uses the National Weather Service (NWS) API for weather data
- Implements data validation using Zod
- Written in TypeScript with Node.js
- Uses ES modules (type: "module" in package.json)
Dependencies
@modelcontextprotocol/sdk: ^1.12.1zod: ^3.25.41typescript: ^5.8.3 (dev dependency)@types/node: ^22.15.26 (dev dependency)
Development
- Clone the repository
- Install dependencies:
npm install - Build the project:
npm run build
API Integration
The server uses the National Weather Service (NWS) API with the following endpoints:
- Alerts:
https://api.weather.gov/alerts - Points:
https://api.weather.gov/points/{lat},{lon} - Forecast: Uses the forecast URL provided by the points endpoint
Error Handling
The server includes robust error handling for:
- API request failures
- Invalid coordinates
- Missing or malformed data
- Network issues