MCP Weather

MCP Weather

By jpan8866 GitHub

A weather Model context protocol (MCP) tool server to allow AI agents to have access to real time weather data.

Overview

what is MCP Weather?

MCP Weather is a weather information service built with the Model Control Protocol (MCP) framework that provides access to real-time weather data from the National Weather Service (NWS).

how to use MCP Weather?

To use MCP Weather, clone the repository, install the dependencies, and run the service using Python. You can then access weather alerts and forecasts through the provided API.

key features of MCP Weather?

  • 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

use cases of MCP Weather?

  1. Providing real-time weather updates to AI assistants
  2. Alerting users about severe weather conditions in their area
  3. Offering detailed weather forecasts for planning outdoor activities

FAQ from MCP Weather?

  • Can MCP Weather provide weather data for all US states?

Yes! MCP Weather can retrieve weather alerts and forecasts for any US state.

  • What are the requirements to run MCP Weather?

You need Python 3.13 or higher and the specified dependencies.

  • How can I contribute to MCP Weather?

Contributions are welcome! You can submit a Pull Request on the GitHub repository.

Content

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

No tools information available.
No content found.