Leave Management MCP Server

An MCP (Model Context Protocol) server for employee leave management, built with FastMCP and Python.

Features

• Check leave balance — query remaining leave days for an employee

• Apply for leave — submit leave requests for specific dates

• View leave history — retrieve past leave records

• Greeting resource — personalized greeting endpoint

Prerequisites

• Python 3.14+

• uv — fast Python package manager

• Claude Desktop (to use the server with Claude)

Environment Setup

1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Verify the installation:

uv --version

2. Clone the repository

git clone <your-repo-url>
cd mcp1_leave_management

3. Install Python 3.14

uv will read the .python-version file and auto-install the correct Python version:

uv python install

4. Create a virtual environment

uv venv

5. Activate the virtual environment

# macOS / Linux
source .venv/bin/activate

# Windows
.venv\Scripts\activate

6. Install the mcp dependency

uv add mcp

7. Verify the installation

python -c "from mcp.server.fastmcp import FastMCP; print('MCP installed successfully')"

Running the Server

Standalone (for testing)

python main.py

With MCP Inspector (interactive testing)

npx @modelcontextprotocol/inspector python main.py

Then open http://localhost:5173 in your browser to interact with the tools.

Connecting to Claude Desktop

1. Find your Claude Desktop config file

2. Add the server configuration

Open the config file and add an entry under mcpServers:

{
  "mcpServers": {
    "leave-management": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp1_leave_management",
        "python",
        "main.py"
      ]
    }
  }
}

Replace /absolute/path/to/mcp1_leave_management with the actual path on your machine.

3. Restart Claude Desktop

Quit and relaunch Claude Desktop. The leave management tools will appear in the tool panel.

Available Tools

Example usage (in Claude)

Check leave balance for employee E001
Apply leave for E002 on 2025-06-10 and 2025-06-11
Show leave history for E001

Mock Data

The server starts with two pre-seeded employees:

Data is held in memory and resets each time the server restarts.

Project Structure

mcp1_leave_management/
├── main.py           # MCP server and tool definitions
├── pyproject.toml    # Project metadata and dependencies
├── uv.lock           # Locked dependency versions
├── .python-version   # Pinned Python version (3.14)
└── README.md

Terminal setup steps from zero

uv venv --python 3.14 .venv
source .venv/bin/activate
which python
python --version
uv pip install mcp
uv
uv init
uv pip show mcp
uv run mcp install main.py