Weather-MCP-Agent-Real-Time-AI-Tool-Integration-with-FastMCP-Claude

A production-style Weather Assistant built with FastMCP, exposing real-time weather as AI tools and integrated with Claude Desktop via MCP. Demonstrates tool calling, backend–LLM integration, secure API handling, and real-world GenAI architecture.

🌦️ Weather MCP Agent (Production-Style Tool Integration Project)

A real-world Weather Assistant Agent built using FastMCP, OpenWeather API, and tool integration with Claude Desktop via MCP server configuration.
This project demonstrates how to expose backend Python tools to AI clients in a production-style architecture.

✅ Perfect for showcasing in interviews (AI Engineer, Data Scientist, GenAI Developer)

---

🚀 Features

• 🔌 MCP Server using FastMCP
• 🧠 Tool exposed: get_weather_data(city)
• 🌐 Real-time weather using OpenWeather API
• 🔐 Secure API key using .env
• 🧩 Claude Desktop integration via MCP config
• 🖥️ Production-style architecture
• 📦 Clean and simple structure

---

🧠 Architecture

User (Claude Desktop)
      ↓
Tool Call → MCP Server (FastMCP)
      ↓
Python Tool → OpenWeather API
      ↓
Response back to Claude

---

📂 Project Structure

weather-agent/
│
├── weather_agent_mcp.py        # Main MCP server + tool
├── requirements.txt            # Dependencies
├── .env                        # API key (not committed)
└── claude_desktop_config.json  # Claude MCP connector config

---

🛠️ Tech Stack

• Python 3.10+
• FastMCP
• Requests
• Python-dotenv
• OpenWeather API
• Claude Desktop (MCP tools)

---

🔑 Setup Environment

Create a .env file in your project folder:

OPENWEATHER_API_KEY=your_api_key_here

---

📦 Install Dependencies

pip install -r requirements.txt

Example requirements.txt:

fastmcp
requests
python-dotenv

---

▶️ Run the MCP Server

python weather_agent_mcp.py

Your server runs using stdio transport:

if __name__ == "__main__":
    mcp.run(transport="stdio")

---

🔧 Claude Desktop Integration

Add this in your Claude MCP config:

{
  "mcpServer": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\MUTHU SELVAM\\OneDrive\\Desktop\\VS CODE\\own projects\\weather agent",
        "run",
        "weather_agent_mcp.py"
      ]
    }
  }
}

After this, Claude automatically detects your tool.

---

💬 Example Usage

User asks in Claude:

What is the current weather in Bangalore?

Claude calls your tool internally:

{
  "city": "Bangalore"
}

Tool response:

Weather in Bangalore:
- Condition: clear sky
- Temperature: 25°C (feels like 24.7°C)
- Humidity: 40%

---

🎯 Why This Project Is Strong

This project demonstrates:

• Real AI tool calling
• MCP server architecture
• Backend + LLM integration
• API handling
• Secure env handling
• Production-style design

This is ideal for roles like:

• AI Engineer
• GenAI Developer
• Applied Data Scientist
• ML Engineer

---

🚀 Future Improvements (Optional but Powerful)

• Add logging (logging)
• Add async version (httpx)
• Add more tools (forecast, AQI, etc.)
• Add FastAPI UI
• Add Docker support
• Add unit tests with pytest

---

👨‍💻 Author

Muthu Selvam
AI & Data Science Enthusiast
Building real-world GenAI projects

---