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 mainThis server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues