Skip to main content
Glama
anjalimahapatra2004

AI HR Leave Management MCP Server

README.md
# 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
```bash
pip install -r requirements.txt
```

### 2. Configure `.env`
```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
```bash
python backend/app.py
```

### 4. Run Frontend
```bash
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