HR Assistant MCP Server

Практичный локальный HR-ассистент для онбординга сотрудников, учёта отпусков, координации встреч и заявок по рабочему месту. Он подключается к любому MCP-совместимому клиенту и работает без базы данных или платных сервисов.

Структура системы

MCP-сервер — единая точка входа для HR-процессов. Функции сотрудников, отпусков, встреч и заявок вынесены в отдельные модули, а отправка уведомлений по электронной почте остаётся необязательной. Данные хранятся локально в памяти для быстрой демонстрации возможностей.

Related MCP server: multi-mail-mcp

Возможности

• Онбординг сотрудников одним вызовом инструмента.

• Ведение справочника сотрудников с отношениями «руководитель — непосредственный подчинённый».

• Проверка остатков отпусков, подача заявок на отпуск и просмотр истории отпусков.

• Планирование, просмотр и отмена ориентационных или HR-встреч.

• Создание и обновление заявок на ноутбук, гарнитуру, пропуск и другие предметы рабочего места.

• Отправка уведомлений через SMTP при локально настроенных учётных данных.

• Запуск с детерминированными тестовыми сотрудниками для немедленного тестирования.

Приступая к работе

Требования: Python 3.10 или новее.

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

Сервер общается через стандартный ввод/вывод, как и ожидают клиенты MCP. Он не выводит интерактивное приглашение при прямом запуске.

Запускайте набор тестов при каждом изменении:

python -m pytest

Подключение к MCP-клиенту

Укажите абсолютный путь к клонированному проекту в конфигурации вашего клиента.

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

После подключения отправьте один из следующих запросов:

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.

Основные инструменты

onboard_employee одним вызовом создаёт запись о сотруднике, лицевой счёт отпуска и стандартный набор заявок: ноутбук, гарнитуру и пропуск. Отдельный ориентционное встреча после подтверждения времени.

Найтройка почты

Почта это опционально. Скопруйте .env.example в .env, заполните SMTP-настройки, если хотите использовать send_notification.

Copy-Item .env.example .env

Файл .env is ignored by Git. All other HR-функции work без настройки почты.

Файлы проекта

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