MCP Weather: Hyperlocal Real-Time Forecasts & Seamless AI Integration

MCP Weather: Empower AI agents with real-time, hyperlocal forecasts—precision-driven decisions, seamless integration, no guesswork." )

Visit Repository

✨ Research And Data

4.5(171 reviews)

256 saves

119 comments

31% of users reported increased productivity after just one week

About MCP Weather

What is MCP Weather: Hyperlocal Real-Time Forecasts & Seamless AI Integration?

MCP Weather is a Python-based tool built using the Model Control Protocol (MCP) framework, designed to deliver hyperlocal weather data directly from the National Weather Service (NWS) API. It acts as a bridge between AI assistants and real-time weather information, offering two core capabilities: retrieving active weather alerts by state and providing detailed forecasts based on precise coordinates.

How to Use MCP Weather: Hyperlocal Real-Time Forecasts & Seamless AI Integration?

To get started:

Clone the repository and install dependencies using uv:

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

Run the service with:

uv run weather.py

Access tools via MCP commands. For example, to get California’s alerts:
```
mcp call mcp-weather.get_weather_alerts --params '{"state": "CA"}'
```

MCP Weather Features

Key Features of MCP Weather: Hyperlocal Real-Time Forecasts & Seamless AI Integration?

Real-Time Alerts: Instant access to NWS warnings for any U.S. state (e.g., flash flood alerts for Texas).
Location-Specific Forecasts: Get granular data like temperature and precipitation using coordinates (e.g., latitude 34.0522, longitude -118.2437 for Los Angeles).
User-Friendly Output: Cleanly formatted responses for easy parsing by AI systems.
MCP-Native Integration: Built to work seamlessly with AI assistants via the MCP framework.

Use Cases of MCP Weather: Hyperlocal Real-Time Forecasts & Seamless AI Integration?

Whether you’re building a chatbot for emergency management or a travel planner app, MCP Weather fits scenarios like:

Emergency Response: Automatically notify users about severe thunderstorms in their state.
Travel Planning: Fetch hourly forecasts for a hiking trail’s exact location.
Agriculture: Monitor drought conditions across farmland coordinates.

MCP Weather FAQ

FAQ: Hyperlocal Real-Time Forecasts & Seamless AI Integration?

Q: Does it require Python 3.8+?
Yes, Python 3.8 or higher is needed for dependency compatibility.

Q: Can I use it outside the U.S.?
Currently, coverage is limited to NWS data, which focuses on U.S. territories.

Q: What if the API returns an error?
Check the state code format (e.g., “CA” not “California”) and ensure internet connectivity.

Q: How do I troubleshoot MCP calls?
Use mcp logs for detailed error messages and verify tool permissions.

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:

Weather Alerts : Get active weather alerts for any US state
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

Clone this repository:

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

cd mcp-weather

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.