Nws Server

This project is an MCP (Model Context Protocol) server that provides weather data using the National Weather Service (NWS) API.

This is not an official NWS product. It is a custom implementation designed to integrate with MCP clients like Claude or OpenAI.

Features

• Get weather alerts for a US state
• Get weather forecast for a specific location (latitude/longitude)

Requirements

• Node.js (v18+ recommended)
• npm

Installation

1. Clone the repository:

git clone https://github.com/Lil-Code30/nws-mcp-server.git
cd nws-mcp-server

2. Install dependencies:

npm install

Build

Compile the TypeScript code:

npm run build

Usage

Run the MCP server:

npm start

The server runs via stdio and exposes two tools:

1. get_alerts

• Description: Get weather alerts for a US state.
• Input:
  • state: Two-letter state code (e.g., CA, NY)
• How it works:
  • Uses the NWS Alerts endpoint: /alerts?area={STATE}
  • Example: https://api.weather.gov/alerts?area=CA
  • Returns active alerts or a message if none are found.

2. get-forecast

• Description: Get weather forecast for a location.
• Input:
  • latitude: Latitude of the location (US only)
  • longitude: Longitude of the location (US only)
• How it works:
  • Uses the NWS Points endpoint: /points/{lat},{lon}
  • Example: https://api.weather.gov/points/37.7749,-122.4194
  • Retrieves the forecast URL from the points response, then fetches forecast data from that URL.
  • Returns a formatted forecast for the location.

NWS API Reference

• Full documentation: National Weather Service API

Notes

• Only US locations are supported by the NWS API.
• The server is designed for integration with MCP clients.

Integrating with Claude or Other MCP Clients

You can connect this MCP server to any MCP-compatible client (like Claude, OpenAI, or custom apps) using the Model Context Protocol. The server communicates via stdio, so you can run it locally and connect via a tool or agent interface.