This server provides real-time weather information and alerts for US locations via the Model Context Protocol (MCP).
- Get weather alerts for any US state using the
get-alerts
tool with a two-letter state code - Fetch detailed weather forecasts with the
get-forecast
tool by providing latitude and longitude coordinates - Access temperature, wind conditions, and short forecast descriptions
- Utilizes the National Weather Service (NWS) API for real-time data
- Designed for integration with AI agents
Weather MCP Server
A Model Context Protocol (MCP) server that provides weather information and alerts for US locations using the National Weather Service (NWS) API. This server is designed to be used by AI agents through the Model Context Protocol.
Features
- Tool for getting weather alerts for any US state
- Tool for getting detailed weather forecasts for any US location using coordinates
- Supports temperature, wind conditions, and short forecast descriptions
- Real-time data from the National Weather Service
Prerequisites
- Node.js (v16 or higher)
- npm or yarn package manager
Installation
- Clone the repository:
- Install dependencies:
- Build the application:
MCP Tools
The server provides two MCP tools that can be used by AI agents:
get-alerts
Get weather alerts for a specific US state.
Parameters:
state
: Two-letter state code (e.g., CA, NY)
Example response:
get-forecast
Get weather forecast for a specific location using coordinates.
Parameters:
latitude
: Latitude of the location (-90 to 90)longitude
: Longitude of the location (-180 to 180)
Example response:
Project Structure
Technical Details
- Built with TypeScript
- Implements Model Context Protocol (MCP) server
- Uses @modelcontextprotocol/sdk for MCP server implementation
- Interfaces with the National Weather Service (NWS) API
- ES2022 target with Node16 module resolution
Development
To modify or extend the server:
- Make changes in the
src/index.ts
file - Rebuild the application:
Dependencies
- @modelcontextprotocol/sdk: MCP server implementation framework
- zod: Runtime type checking and validation for tool parameters
- TypeScript: Development dependency for type safety
License
ISC
Notes
- This server only works for US locations as it uses the National Weather Service API
- API requests are rate-limited and require a User-Agent header
- All coordinates should be in decimal degrees format
- This is not a standalone CLI application, but rather a server that provides tools for AI agents through the Model Context Protocol
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides AI agents with tools to retrieve weather alerts and detailed forecasts for US locations using the National Weather Service API.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools to fetch weather alerts for US states and forecasts based on latitude/longitude coordinates using the US National Weather Service API.Last updated -271TypeScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that provides real-time weather information and 5-day forecasts to AI assistants, supporting multiple languages and flexible units.Last updated -38TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI models to fetch weather alerts and detailed forecasts for US locations using the National Weather Service API.Last updated -71TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that provides comprehensive weather data and forecasts through the OpenWeatherMap API, enabling AI assistants to access real-time weather information, forecasts, air quality data, and location services.Last updated -1120JavaScriptMIT License