Leave Management MCP Server

This project provides a simple MCP server for an employee leave-management system built with UV and Python.

Features

• Add employees
• List all employees
• Add leave entries for an employee
• List leave entries for an employee
• Delete leave entries
• Startup and tool logging for troubleshooting

Project structure

• src/leave_management_mcp/server.py – MCP tool definitions and in-memory leave data store
• src/leave_management_mcp/__init__.py – package exports and entry point
• tests/test_leave_management.py – regression tests for the core behavior
• leave_management_mcp.log – runtime log file generated by the server

Run locally

From the project root:

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run leave-management-mcp

The server uses stdio transport, which is the recommended transport for Claude Desktop.

Claude Desktop config

Create or edit this file:

%APPDATA%\Claude\claude_desktop_config.json

Use this exact config:

{
  "mcpServers": {
    "leave-management": {
      "command": "C:\\Users\\VIJAY\\AppData\\Local\\Programs\\Python\\Python314\\Scripts\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\VIJAY\\Codebase\\mcp\\leave-management",
        "run",
        "leave-management-mcp"
      ]
    }
  }
}

Important:

• The earlier path C:\Users\VIJAY\.local\bin\uv.exe was invalid on this machine.
• The actual installed UV path is under the Python Scripts folder.
• Restart Claude Desktop after saving the file.

Example prompts in Claude

• "Add employee E001, Alice Johnson"
• "List all employees"
• "Add leave for E001 from 2026-08-20 to 2026-08-22 as annual"
• "Show leave records for E001"
• "Delete leave for E001 from 2026-08-20 to 2026-08-22"

Logging

The server writes logs to:

• stderr for immediate output
• leave_management_mcp.log in the project root for persisted troubleshooting

This helps confirm whether the MCP server is starting correctly when Claude Desktop launches it.

Validation

Run the test suite:

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run pytest -q

Verified result:

2 passed in 2.85s

The project passes the current regression tests and the server launch path has been verified.