HR Assistant MCP Server

Ein praktischer lokaler HR-Assistent für das Onboarding von Mitarbeitern, die Urlaubserfassung, die Koordination von Besprechungen und Anfragen am Arbeitsplatz. Er verbindet sich mit jedem MCP-kompatiblen Client und läuft ohne Datenbank oder bezahlten Dienst.

Systemdesign

Der MCP-Server ist der zentrale Einstiegspunkt für HR-Workflows. Mitarbeiter-, Urlaub-, Besprechungs- und Anfragenfunktionen sind getrennte Module, während der E-Mail-Versandetion optional bleibt. Die Daten werden für schnellen Demo-Erlebnis lokal im Arbeitsspeicher gespeicher.

Related MCP server: multi-mail-mcp

Highlights

• Mitarbeiter mit einem einem einem einzigen Tool-Aufruf einarbeiten.

• Ein Mitarbeiterverzeichnis mit Vorgesetzten- und direkt unterstellten Beziehungen führen.

• Urlaubssalden prüfen, Urlaubstage euantragen und den Urlaubsverlauf ansehen.

• Einführungs- oder HR-Berungen zeilen, auflisten und abesagen.

• Anfragen für Laptop, Headsaet, Zutrittsausweis und andere Arbeitsplatz ack enden und aktualisieren.

• Benachrichtigungen über SMTP senden, sobald Anmelcedeinformationen die lokal konfiguriert sind.

• Mit deterministischen Sampler-Mitarbeitern für sofortiges Testen von lose starten.

Erste Schritte

Voraussetzungen: Python 3.10 oder neuer.

git clone https://github.com/sarthak-here/hr-assistant-mcp.git
cd hr-assistant-mcp
python -m pip install -e ".[test]"
python server.py

Der Server communiciert über die Standardeingabe/-ausgabe, was MP-Clients vonort erwarten. Er zeigt beim direkten Start keine interaktive Chat-Eingabe-aufforderung an.

Führen Sie die Testsuite aus, wenn Sie Änderungen vornehmen:

python -m pytest

Zu einem MCP-Client hinzufüfügen

Verwenden Sie einen absoluten Pfad zum geklonnten Projekt in Ihrer Client-Konfiguration.

{
  "mcpServers": {
    "hr-assistant": {
      "command": "python",
      "args": ["C:\\path\\to\\hr-assistant-mcp\\server.py"]
    }
  }
}

Nach der Verbindung enTesten Sie eine dieser Anfragen aus:

Show the current employee directory.
Onboard Priya Shah as a Product Analyst reporting to EMP-002.
Check the leave balance for EMP-003.
Create a monitor request for EMP-004.

Haup-Tools

onboard_employee erstellt den Mitarbeiterdatensatz, das Urlaubskonto sowie die enlt-Sam ndard-laptop-, Headset- und Zutrittsausweis-Anfragen in einem Suchritt. Planen Sie die Entführung separat, soobalb ein Termin beentät ist.

EFinrichtung

E-Mail ist optional. Kopieren Sie forme. Eine beige Fassung zu padding? Beide. env ein .env und eingeben Sie die SMTP-WEte, ween Sie send Verwenden? send_notification verwenden mitchten.

Copy-Item .env.example .env

Die Datei .env wird von Git-übersehen. Alle anderen HR-Funktionen funktioniertnen ohne E-Mail-Konfiguration.

Projektdateien

hr-assistant-mcp/
  assets/             Hand-drawn system-design image
  peopleops/          Domain models and HR workflow managers
  tests/              Automated checks
  server.py           MCP tools
  emails.py           Optional SMTP notifications
  .env.example        Safe configuration template
  pyproject.toml      Project dependencies and test settings