Weather MCP Server

by akaramanapp

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

  1. Clone the repository:
git clone https://github.com/akaramanapp/weather-mcp-server.git cd weather-mcp-server
  1. Install dependencies:
npm install
  1. 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:

  1. Make changes in the src/index.ts file
  2. 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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

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.

  1. Features
    1. Prerequisites
      1. Installation
        1. MCP Tools
          1. get-alerts
          2. get-forecast
        2. Project Structure
          1. Technical Details
            1. Development
              1. Dependencies
                1. License
                  1. Notes

                    Related MCP Servers

                    • -
                      security
                      -
                      license
                      -
                      quality
                      Provides a Model Context Protocol server that enables large language models to query and retrieve real-time weather forecasts for cities and regions across China.
                      Last updated -
                      Python
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol server that provides comprehensive weather data querying capabilities based on the Caiyun Weather API, supporting real-time weather, forecasts, and alerts with multi-language support.
                      Last updated -
                      7
                      1
                      TypeScript
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A customizable Model Context Protocol server implementation that enables AI models to interact with external tools including weather queries, Google search, and camera control functionality.
                      Last updated -
                      8
                      Python
                      Apache 2.0
                      • Linux
                      • Apple
                    • -
                      security
                      -
                      license
                      -
                      quality
                      A Model Context Protocol server that provides current weather information and 3-day forecasts for specified cities using the Open-Meteo API.
                      Last updated -
                      Python

                    View all related MCP servers

                    ID: g9xlsrhp8g