Weather MCP Server

# 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 ```bash npm install npm run build ``` ## Usage This server is designed to be used as a CLI tool and can be installed globally: ```bash 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: ```json { "state": "CA" // Two-letter state code } ``` ### 2. Get Weather Forecast Retrieves weather forecast for a specific location using coordinates. Example parameters: ```json { "latitude": 37.7749, "longitude": -122.4194 } ``` ## Technical Details - Built using the `@modelcontextprotocol/sdk` for 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.1 - `zod`: ^3.25.41 - `typescript`: ^5.8.3 (dev dependency) - `@types/node`: ^22.15.26 (dev dependency) ## Development 1. Clone the repository 2. Install dependencies: `npm install` 3. 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