🛠️ MCP Leave Manager Server
A beginner-friendly guide to setting up your first MCP server using Python, UV, VS Code, and Claude AI.
📌 What Is an MCP Server?
MCP (Model Context Protocol) might sound complex, but it's simply a bridge between your AI assistant (like ChatGPT or Claude) and your real-world tools, files, or systems.
Instead of AI just talking — MCP lets it take action.
🔍 Example:
Once connected to your MCP Leave Manager server, you could ask:
"Hey AI, how many leaves did Employee E001 take in August?"
The MCP server reads the data and responds:
"E001 was on leave for 5 days."
Simple. Automated. Smart.
🚀 Why Use MCP Servers?
-
✅ Convenience – No more switching between tools manually.
-
⚙️ Automation – Let AI handle repetitive or technical tasks.
-
🔒 Safety – You control exactly what the AI can access.
-
🔗 Flexibility – Connect anything from cloud apps to local scripts.
⚠️ Limitations
-
🧠 Requires basic technical setup.
-
🔌 Not plug-and-play — still early tech.
-
🐢 Can be slightly slower due to communication layer.
-
🛠️ Needs occasional maintenance.
🧰 Requirements
-
A Laptop / PC
-
VS Code (latest)
-
Claude Desktop App
-
Python (from python.org — NOT Microsoft Store)
📥 Installation & Setup
1️⃣ Install Python & Open Terminal (as Administrator)
pip install uv
uv pip install mcp
uv pip install mcp[cli]
⚠️ Install UV first before installing MCP.
2️⃣ Create Project Folder in VS Code
uv init
This generates multiple files — leave them untouched.
3️⃣ Open main.py and Paste Your MCP Server Code
Example MCP server reference: https://github.com/DhruvProgrammer/MCP
4️⃣ Install MCP Server into Claude
uv run mcp install main.py
5️⃣ Open Claude → Ctrl + , → Developer Settings
✅ If you see Leave Manager (running) in blue — your MCP server is live!
❌ If it shows Failed / Disconnected, continue below.
🛠️ Common Issues & Fixes
🟡 Inside Claude:
-
Enable the MCP tool under Settings → Tools → Web Search → Leave Manager
-
If missing, open Task Manager → End Claude → Reopen after 30-60 sec
🔴 Outside Claude:
-
Restart your PC — surprisingly effective for random bugs.
-
Uninstall Python from Control Panel if it was installed via Microsoft Store.
-
Reinstall Python from python.org only.
-
Ensure Python and UV paths exist in Environment Variables → Path.
🧠 Still Stuck?
Open Claude → Ctrl + , → Developer → Open Logs → Copy & Paste logs into ChatGPT — AI will tell you the issue.
✅ Conclusion
An MCP server isn’t a scary tech beast — it’s just a smart middleman that gives your AI hands to actually perform tasks.
Yes, setup takes a bit of patience — but once it’s working, it feels like magic.
You're not just chatting with AI anymore — you're commanding it.
✨ Built with curiosity and caffeine by Dhruv ✨
