mcp_AI

🌤️ Weather Alert & Forecast MCP Tool

A lightweight microservice using FastMCP that fetches weather alerts and forecasts from the National Weather Service API. This tool provides U.S. state-level alerts and location-based forecasts.

🚀 Features

Get Active Alerts: Fetch active weather alerts for any U.S. state using its two-letter abbreviation.
Get Forecast: Retrieve the upcoming weather forecast for a specific latitude and longitude.
Asynchronous Requests: Efficient use of httpx for non-blocking API calls.
Formatted Output: Readable string output ideal for chatbot integration or quick CLI access.

Related MCP server: Weather MCP Server

👷️ Installation

pip install httpx pip install mcp # Or your local FastMCP package

📦 Usage

Make sure you have Python 3.9+ and mcp installed.

python weather.py

The MCP server will start and listen for commands using the stdio transport.

🧰 Available Tools

`get_alerts(state: str)`

Fetch active weather alerts for a U.S. state.

Arguments:

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

Returns:
A formatted string of current alerts or a message if none are available.

`get_forecast(latitude: float, longitude: float)`

Fetch a detailed forecast for a specific location.

Arguments:

latitude: Latitude of the location (e.g., 37.7749)
longitude: Longitude of the location (e.g., -122.4194)

Returns:
Up to 5 periods of detailed forecast data (e.g., "Tonight", "Monday").

🧪 Example Output

Alert Example:

Event: Flood Warning Area: San Joaquin County Severity: Moderate Description: Flooding is expected in low-lying areas... Instructions: Turn around, don’t drown...

Forecast Example:

Tonight: Temperature: 54°F Wind: 10 mph NW Forecast: Clear skies with calm wind. --- Monday: Temperature: 68°F Wind: 5 to 10 mph W Forecast: Sunny and warm.