# 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
```bash
npm install
```

### Run the server
```bash
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