Enables environment variable management for storing and accessing API keys securely
Used for MCP Protocol specification and repository hosting, allowing users to contribute to the project through pull requests
Provides the agent framework for the weather alert system, enabling interactive conversation with memory and structured function calling
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Weather Alert Agentshow me current weather alerts for Florida"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π¦οΈ 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, andFastMCPπ οΈ 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
Clone the repository
git clone https://github.com/MokshadaRaibagkar/mcp-weather-alert-agent.git cd mcp-weather-alert-agentCreate virtual environment
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activateInstall dependencies
pip install -r requirements.txtSet 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
Component | Technology |
MCP Framework | |
LLM | |
Agent Framework | |
Weather API | |
Development |
π€ Contributing
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
π©βπ» Author
Mokshada Raibagkar
β Star this repo if it helped you!
Made with β€οΈ and β