🌍 WeatherMind AI

MCP-Powered Weather Intelligence Agent

WeatherMind AI is an AI-powered weather intelligence system built using FastMCP, Claude Desktop, and OpenWeather APIs.

The project provides real-time trusted weather data through MCP tools, allowing Claude to perform contextual reasoning and generate intelligent recommendations dynamically.

Instead of hardcoded chatbot responses, the system uses structured live environmental data and LLM reasoning to create a modern AI-agent workflow.

🚀 Features

• 🌦️ Real-time global weather data
• 🌫️ Air Quality Index (AQI) analysis
• ⚠️ Weather alert monitoring
• 📅 Forecast intelligence
• 🤖 Claude-powered contextual reasoning
• 🔗 MCP tool integration
• ⚡ Async API architecture
• 🌍 Global city support using OpenWeather APIs

🧠 Architecture

User Query ↓ Claude Desktop ↓ MCP Tool Calls ↓ WeatherMind AI MCP Server ↓ OpenWeather APIs ↓ Structured Weather Data ↓ Claude Reasoning + Intelligent Response

🛠️ Tech Stack :

• Python
• FastMCP
• Claude Desktop
• OpenWeather API
• HTTPX
• AsyncIO
• MCP Protocol

📂 Project Structure :

weather/ │ ├── main.py ├── .env ├── .gitignore ├── README.md ├── requirements.txt └── screenshots/

⚙️ Installation :

1. Clone Repository :

• git clone cd weather-global

1. Create Virtual Environment :

• uv venv

1. Activate Environment : Windows

• .venv\Scripts\activate

1. Install Dependencies

• uv sync

🔑 Environment Variables :

Create a .env file: OPENWEATHER_API_KEY=your_api_key_here

▶️ Run MCP Server

• uv run main.py

💬 Example Prompts

• What is the weather in Chennai today?
• Is Delhi air quality safe for outdoor activities?
• Should I travel to Mumbai today?
• What should I wear in Bangalore today?

🧩 The MCP server is responsible for:

• trusted real-time data retrieval
• external API integration
• structured tool outputs

🧩 Claude Desktop is responsible for:

• contextual reasoning
• intelligent recommendations
• natural language understanding
• This creates a scalable AI-agent architecture using live external tools.

🔮 Future Improvements

• Voice-enabled AI weather assistant
• Personalized user memory
• Severe weather notifications
• Historical climate analytics
• RAG-based climate knowledge integration

📸 Screenshots Weather queries