README.md•1.38 kB
# 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