AI HR Leave Management Chatbot
Real MCP Protocol + Groq LLM + FastAPI + Streamlit A real MCP (Model Context Protocol) based HR chatbot using Groq LLM + FastAPI + Streamlit.
Architecture
User → Streamlit → FastAPI → Groq LLM → MCP Client → MCP Server → Tools
Tech Stack
- MCP SDK — Real stdio transport protocol
- Groq LLM — llama-3.3-70b-versatile
- FastAPI — Backend REST API
- Streamlit — Frontend UI
Project Structure
mcp_chatbot/
├── .env
├── requirements.txt
├── mcp_server/server.py ← MCP Tools
├── backend/agent.py ← MCP Client + Groq
├── backend/app.py ← FastAPI
├── frontend/app.py ← Streamlit UI
└── utils/config.py
Setup
1. Install dependencies
pip install -r requirements.txt
2. Configure .env
GROQ_API_KEY=your_groq_api_key_here
GROQ_MODEL=llama-3.3-70b-versatile
FASTAPI_HOST=127.0.0.1
FASTAPI_PORT=8000
3. Run Backend
python backend/app.py
4. Run Frontend
streamlit run frontend/app.py
MCP Tools
| Tool | Description |
|---|---|
apply_leave | Apply leave request |
check_leave_balance | Check remaining leaves |
get_leave_history | Past leave records |
cancel_leave | Cancel last leave |
get_holidays | Upcoming holidays |
get_employee_info | Employee details |
Step 4 — Initialize and push bashgit init git add . git commit -m "Initial commit - AI HR MCP Chatbot" git branch -M main git remote add origin https://github.com/anjalimahapatra2004/mcp_tool.git git push -u origin main