Leave Management MCP Server

Dieses Projekt bietet einen einfachen MCP-Server für ein Mitarbeiter-Urlaubsverwaltungssystem, das mit UV und Python erstellt wurde.

Funktionen

• Mitarbeiter hinzufügen

• Alle Mitarbeiter auflisten

• Urlaubseinträge für einen Mitarbeiter hinzufügen

• Urlaubseinträge für einen Mitarbeiter auflisten

• Urlaubseinträge löschen

• Start- und Tool-Protokollierung zur Fehlerbehebung

Related MCP server: leave-manager-mcp-server

Projektstruktur

• src/leave_management_mcp/server.py – Definitionen der MCP-Tools und In-Memory-Urlaubsdatenspeicher

• src/leave_management_mcp/__init__.py – Paketexporte und Einstiegspunkt

• tests/test_leave_management.py – Regressionstests für das Kernverhalten

• leave_management_mcp.log – Laufzeitprotokolldatei, die vom Server erzeugt wird

Lokal ausführen

Aus dem Projektstammverzeichnis:

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

Der Server verwendet den stdio-Transport, der für Claude Desktop empfohlen wird.

Konfiguration für Claude Desktop

Erstellen oder bearbeiten Sie diese Datei:

%APPDATA%\Claude\claude_desktop_config.json

Verwenden Sie genau diese Konfiguration:

{
  "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"
      ]
    }
  }
}

Wichtig:

• Der frühere Pfad C:\Users\VIJAY\.local\bin\uv.exe war auf diesem Rechner ungültig.

• Der tatsächlich installierte UV-Pfad befindet sich im Ordner „Python Scripts“.

• Starten Sie Claude Desktop neu, nachdem Sie die Datei gespeichert haben.

Beispiel-Prompts in Claude

• "Füge Mitarbeiter E001, Alice Johnson hinzu"

• "Liste alle Mitarbeiter auf"

• "Füge Urlaub für E001 vom 2026-08-20 bis 2026-08-22 als Jahresurlaub hinzu"

• "Zeige Urlaubseinträge für E001"

• "Lösche Urlaub für E001 vom 2026-08-20 bis 2026-08-22"

Protokollierung

Der Server schreibt Protokolle in:

• stderr für die sofortige Ausgabe

• leave_management_mcp.log im Projektstammverzeichnis für die dauerhafte Fehlerbehebung

Dies hilft zu überprüfen, ob der MCP-Server korrekt startet, wenn Claude Desktop ihn ausführt.

Validierung

Führen Sie die Testsuite aus:

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

Verifiziertes Ergebnis:

2 passed in 2.85s

Das Projekt besteht die aktuellen Regressionstests, und der Serverstartpfad wurde verifiziert.