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:

git clone https://github.com/akaramanapp/weather-mcp-server.git
cd weather-mcp-server

Install dependencies:

npm install

Build the application:

npm run build

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:

{
  "content": [
    {
      "type": "text",
      "text": "Active alerts for CA: ..."
    }
  ]
}

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:

{
  "content": [
    {
      "type": "text",
      "text": "Morning: Temperature: 72°F, Wind: 5mph NW, Partly cloudy..."
    }
  ]
}

Project Structure

weather/
├── src/
│   └── index.ts    # Main server code with MCP tool implementations
├── build/          # Compiled JavaScript files
├── package.json    # Project dependencies and scripts
└── tsconfig.json   # TypeScript configuration

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:

npm run build

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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.

Tools

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

MCP Weather Server
adarshem
A
security
A
license
A
quality
A 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 -
2
71
TypeScript
MIT License
MCP Weather Server
aaudeon
A
security
F
license
A
quality
A 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 -
3
8
TypeScript
Weather MCP Server
mauricioTechDev
-
security
F
license
-
quality
A 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 -
71
TypeScript
OpenWeatherMap MCP Server
robertn702
A
security
A
license
A
quality
A 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 -
11
20
JavaScript
MIT License

View all related MCP servers

Weather MCP Server