Weather Alert & Forecast MCP Tool
A lightweight microservice that fetches weather alerts and forecasts from the National Weather Service API, providing U.S. state-level alerts and location-based forecasts.
README Documentation
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
httpxfor non-blocking API calls. - Formatted Output: Readable string output ideal for chatbot integration or quick CLI access.
👷️ 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.
📟 License
This project is licensed under the MIT License.