Skip to content

DeepaliPaspule/Gen-AI-MCP-Generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gen-AI – MCP Generator & Interactive Tutor

A production-ready Generative AI application built using Python, Streamlit, and Google Gemini, designed to generate high-quality MCQs (Multiple Choice Questions) and provide interactive, explanation-driven learning.

This project demonstrates real-world usage of LLMs, structured prompting, JSON parsing, and frontend-backend integration.


📌 What This Project Does

This application uses Gen-AI (Google Gemini) to:

  • Generate exactly 15 MCQs based on:

    • Topic
    • Difficulty level (Easy / Medium / Hard)
  • Display one question at a time

  • Allow users to select options interactively

  • Provide:

    • ✅ Explanation for correct answers
    • ❌ Feedback + correct answer + explanation for wrong answers

This makes the app both a generator and an AI tutor.


🚀 Key Features

  • LLM-driven MCQ generation
  • Interactive learning experience
  • Beginner-friendly explanations
  • Modular, scalable project structure
  • Production-grade prompt design
  • Clean Streamlit UI

🛠 Tech Stack

Layer Technology
Language Python 3.10+
LLM Google Gemini
Frontend Streamlit
Prompt Mgmt JSON
Config Mgmt YAML
Env Mgmt python-dotenv
Validation Pydantic

📁 Project Structure

python-gen-ai/
│
├── apps/
│   └── mcp_generator/
│       └── app.py
│
├── utils/
│   ├── llm_client.py
│   ├── mcp_helper.py
│   └── prompts/
│       └── mcp_generator_prompt.json
│
├── config/
│   ├── config.yaml
│   └── model_config.py
│
├── .env
├── requirements.txt
├── README.md
└── main.py

⚙️ Step-by-Step Setup

1️⃣ Clone the Repository

git clone https://github.com/DeepaliPaspule/python-gen-ai.git
cd python-gen-ai

2️⃣ Create Virtual Environment

python3 -m venv myenv
source myenv/bin/activate   # macOS / Linux

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Configure Environment Variables

Create a .env file:

GEMINI_API_KEY=your_google_gemini_api_key

5️⃣ Run the Application

streamlit run apps/mcp_generator/app.py

📘 Sample Output

Q1. What is a list in Python?
A. Immutable sequence
B. Mutable sequence
C. Dictionary type
D. Set type

❌ Wrong Answer  
Correct Answer: B  
Explanation: Lists are mutable, meaning elements can be modified after creation.

🧠 Why This Project Matters

This project demonstrates:

  • Practical LLM integration
  • End-to-end Gen-AI workflow
  • Frontend + backend orchestration
  • Real-world AI reliability challenges

👩‍💻 Author

Deepali Paspule-CSE Graduate|Gen-AI Enthusiast

About

An AI-powered MCQ Generator and Interactive Tutor built using Python, Streamlit, and Google Gemini. The app generates topic-based MCQs and provides real-time feedback with explanations, enabling active learning.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages