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

🎯 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 ☕