🌦️ 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: MCP Weather Server

🎯 Quick Example

🚀 Getting Started

Prerequisites

• Python 3.8+

• Groq API key (Get one here)

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

Option 2: MCP Dev Server (for testing)

Opens MCP Inspector for tool testing and debugging.

Option 3: MCP Inspector (Visual Interface)

🔧 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:

🧪 Example Interactions

🌐 Tech Stack

🤝 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

• Github

• LinkedIn

⭐ Star this repo if it helped you!

Made with ❤️ and ☕