Leave Management System using MCP (Model Context Protocol)
A minimal, AI-ready Leave Management System built using FastMCP (Model Context Protocol). This project demonstrates how backend business logic can be exposed directly to AI clients (like Claude Desktop), without REST APIs or prompt hacks.
---
✨ Why This Project Exists
Most of us:
- Watch reels
- Save YouTube tutorials
- Bookmark blogs
…but never execute.
This project started when I searched:
“fast api backend for employee management system”
and found this Medium article: 👉 Building a Leave Management System with FastAPI and FastMCP by Madhuri
Instead of just reading it, I asked:
“Why not build it myself?”
That curiosity turned into execution — and this repo is the result.
---
🧠 What This Project Demonstrates
- What MCP (Model Context Protocol) actually looks like in practice
- How AI models can discover and call backend functions
- How to build an AI-first backend, not just an API
- How Claude Desktop interacts with real application logic
---
⚙️ Features
MCP Tools
get_leave_balance(employee_id)apply_leave(employee_id, leave_dates)get_leave_history(employee_id)
MCP Resource
greeting://{name}
System Details
- In-memory mock database
- Claude Desktop compatible (stdio-based MCP server)
- No REST APIs, no frontend — pure MCP
---
🏗️ Project Structure
leave-manager-mcp/ ├── main.py # MCP server (Claude-compatible) ├── requirements.txt # Dependencies └── README.md
yaml Copy code
---
▶️ How It Works (Big Picture)
Claude Desktop ↓ Model Context Protocol (MCP) ↓ FastMCP Server (Python) ↓ Business Logic (Leave Management)
yaml Copy code
Claude discovers tools, understands their schema, and calls them directly.
---
🚀 Getting Started
1️⃣ Create & activate virtual environment
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
2️⃣ Install dependencies
bash
Copy code
pip install -r requirements.txt
3️⃣ Run MCP server (manual testing)
bash
Copy code
python main.py
⚠️ For Claude Desktop, Claude itself starts this process via MCP configuration.
🤖 Claude Desktop Configuration (Windows Example)
json
Copy code
{
"mcpServers": {
"LeaveManagerPython": {
"command": "C:\\Users\\<USERNAME>\\path\\to\\.venv\\Scripts\\python.exe",
"args": [
"C:\\Users\\<USERNAME>\\path\\to\\main.py"
],
"cwd": "C:\\Users\\<USERNAME>\\path\\to\\leave-manager-mcp"
}
}
}
🔁 Restart Claude Desktop after updating the config.
🧪 Example Prompts (Claude)
rust
Copy code
Check leave balance for employee E001
Apply leave for employee E002 on 2025-04-17 and 2025-04-18
Show leave history of E001
Use greeting://Akash
Claude will automatically call the correct MCP tools.
⚠️ Key Learnings
MCP requires a pure stdio process
FastAPI & MCP must be separated
Claude Desktop caches MCP configs aggressively
Execution teaches more than tutorials
🔮 Future Improvements
Add FastAPI (dual-mode: REST + MCP)
Persist data using PostgreSQL
Add authentication & roles
Build AI agents on top of MCP tools
Production deployment
📌 Final Thought
Reading tutorials gives comfort.
Watching reels gives motivation.
But execution gives clarity.
This repo exists because of curiosity — not perfection.
yaml
Copy code
---
## ✅ Why This README Works
✔ Clean headings
✔ Clear story hook
✔ Explains MCP simply
✔ Recruiter / dev friendly
✔ Medium-article ready
✔ No fluff, no noise
---
### 🚀 Next (Recommended)
Now that GitHub is ready, next we should:
1. **Write the Medium article using this repo**
2. **Add FastAPI back cleanly (dual-mode)**
3. **Create an AI agent on top of this**
Just say **which one** and we continue 🔥
