Skip to main content
Glama
MokshadaRaibagkar

MCP Weather Alert Agent

๐ŸŒฆ๏ธ MCP Weather Alert Agent

A lightweight AI agent powered by MCP (Modular Connector Protocol) that fetches real-time weather alerts for any U.S. state using the National Weather Service API.


โœจ Features

  • ๐Ÿค– AI Chat Interface - Interactive conversation with memory

  • ๐ŸŒช๏ธ Real-time Weather Alerts - Live data from National Weather Service

  • โšก Fast Inference - Powered by Groq LLM via LangChain

  • ๐Ÿ”ง MCP Integration - Built with mcp, mcp-use, and FastMCP

  • ๐Ÿ› ๏ธ Tool-based Architecture - Structured function calling


Related MCP server: Weather Alerts MCP Server

๐ŸŽฏ Quick Example

๐Ÿ’ฌ User: "Provide me weather alerts for California"
๐Ÿค– Agent: Calling get_alerts("CA")...
๐ŸŒฆ๏ธ Result: "FLOOD WARNING for Central Valley until 6 PM PST..."

๐Ÿš€ Getting Started

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/MokshadaRaibagkar/mcp-weather-alert-agent.git
    cd mcp-weather-alert-agent
  2. Create virtual environment

    python -m venv .venv
    source .venv/bin/activate  # Windows: .venv\Scripts\activate
  3. Install dependencies

    pip install -r requirements.txt
  4. Set up environment variables

    cp .env
    # Edit .env and add your GROQ_API_KEY

๐Ÿ› ๏ธ Usage

Option 1: Interactive Chat Agent

uv run server/client.py

Option 2: MCP Dev Server (for testing)

uv run mcp dev server/weather.py

Opens MCP Inspector for tool testing and debugging.

Option 3: MCP Inspector (Visual Interface)

uv run mcp dev server/weather.py

๐Ÿ”ง API Reference

get_alerts(state: str) -> str

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

Parameters:

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

Returns:

  • Formatted string with current weather alerts or "No active alerts"

Example:

result = get_alerts("FL")
# Returns: "HURRICANE WARNING for Miami-Dade County..."

๐Ÿงช Example Interactions

Weather Alert Agent initialized! Ask me about weather alerts.

๐Ÿ’ฌ You: What are the current weather alerts for Texas?
๐Ÿ› ๏ธ Calling get_alerts with state: TX
๐ŸŒฆ๏ธ Current alerts for Texas:
- TORNADO WATCH for East Texas until 10 PM CDT
- FLASH FLOOD WARNING for Austin area until midnight

๐Ÿ’ฌ You: Any alerts in California?
๐Ÿ› ๏ธ Calling get_alerts with state: CA
โœ… No active weather alerts for California at this time.

๐ŸŒ Tech Stack

Component

Technology

MCP Framework

MCP Protocol

LLM

Groq

Agent Framework

LangChain

Weather API

National Weather Service

Development

FastMCP


๐Ÿค Contributing

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request


๐Ÿ‘ฉโ€๐Ÿ’ป Author

Mokshada Raibagkar


โญ Star this repo if it helped you!

Made with โค๏ธ and โ˜•

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to fetch real-time weather alerts from the National Weather Service API for any US state. Provides formatted weather warnings, watches, and advisories with severity levels and safety instructions.
    1
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Provides real-time weather alerts for US states using the National Weather Service API, enabling users to fetch and view active weather warnings through natural language queries.
    1
    1
    -
  • F
    license
    B
    quality
    D
    maintenance
    Provides real-time US weather alerts and forecasts by integrating with the National Weather Service API. It enables AI assistants to fetch state-specific alerts and detailed local forecasts using geographic coordinates.
    2
    1
    -