MCP Weather

A weather information service built with the Model Control Protocol (MCP) framework that provides access to National Weather Service (NWS) data.

Overview

MCP Weather is a Python application that serves as an MCP tool, allowing AI assistants to access real-time weather information from the National Weather Service API. The service provides two main functionalities:

1. Weather Alerts: Get active weather alerts for any US state
2. Weather Forecasts: Get detailed weather forecasts for any location in the US by latitude and longitude

Features

• Retrieve active weather alerts by US state code
• Get detailed weather forecasts for specific locations
• Clean, formatted output for easy reading
• Built as an MCP tool for seamless integration with AI assistants

Requirements

• Python 3.13 or higher
• Dependencies:
  • httpx
  • mcp[cli]

Installation

1. Clone this repository:

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

2. You will need the python package manager uv to run the server

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

Usage

Running as an MCP Service

To test the server, run

uv run weather.py

If the server runs successfully without errors, you can make the tool available with the following command:

PATH/uv --directory ABSOLUTE_PATH/mcp-weather run weather.py

Available Tools

Get Weather Alerts

Retrieves active weather alerts for a specified US state.

Parameters:

• state: Two-letter US state code (e.g., CA, NY)

Get Weather Forecast

Retrieves a detailed weather forecast for a specific location.

Parameters:

• latitude: Latitude of the location
• longitude: Longitude of the location

API Reference

The application uses the National Weather Service API to fetch weather data.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgements

• National Weather Service for providing the weather data API
• MCP framework for enabling AI tool integration
• Documentation on Model context protocol: https://modelcontextprotocol.io/quickstart/server#test-with-commands