arifur9993/attendance-engine-mcp

arifur9993/attendance-engine-mcp

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

🕒 attendance-engine MCP

Wage-and-hour answers your AI agent can actually trust.

Ask Claude "Did anyone miss a meal break last Tuesday?" — and have it actually be right.

npm CI License MCP


🤔 The problem

Every HR / payroll / time-tracking team eventually asks Claude (or Cursor, or Windsurf) something like:

"Rahim's punches yesterday were 09:00, 13:00, 14:00, and 18:00. Did he get his meal break under California rules?"

And the LLM does what LLMs do: it eyeballs the timestamps, mumbles something about "yes probably, his lunch looks fine," and moves on. Sometimes it's right. Sometimes it forgets that California requires the meal to start before the end of the 5th hour. Sometimes it counts a 25-minute break as compliant. Sometimes, for an overnight shift that crosses midnight, it just gives up.

You can't put that in front of an auditor. You can't ship it inside a payroll product. You can't trust it with overtime calculations that turn into back-pay liability if they're wrong.

Инструменты были проиндексированы:
apply_rounding

Создаёт округлённое представление отработанных и сверхурочных минут за закрытый день, не теряя точного результата в минутах. Полезно для калифорнийского подхода: «точность до минуты — это база; округление должно быть доказуемо нейтральным». Сохраняйте оба представления и сравнивайте по разным группам.

Параметры
  • inputobjectобязательный
  • roundingobjectобязательный
audit_period_compliance

Провести аудит соблюдения норм по оплате труда и рабочему времени за несколько дней. Для каждого дня определяет посещаемость и оценивает соблюдение норм по обедам и отдыху в соответствии с выбранным набором правил юрисдикции. Возвращает разбивку по дням плюс итоги за период: часы с премией (обед + отдых), дни в зоне риска, дни с опровержимой презумпцией нарушений и тепловую карту по количеству флагов. Используйте для ежемесячной проверки зарплаты, предварительного аудита или панели управления менеджера.

Параметры
  • daysobject[]обязательный

    По одному ResolveDayInput на каждую дату дежурства в окне аудита. Порядок сохраняется.

  • employeeIdstring

    Необязательный идентификатор сотрудника. Повторяется в отчёте для дальнейшей маршрутизации.

  • jurisdictionenumобязательный

    Пакет правил юрисдикции. Сейчас доступна только CA; остальные появятся в последующих минорных версиях.

  • waiversobject[]
diagnose_punches

Выполни триаж сырых отметок времени, прежде чем доверять им: подсчёт, сортировка, дедупликация, выявление дубликатов / нечётного количества отметок / смещения к круглым числам, отчёт о самом длинном и самом коротком промежутках, а также (когда указана ожидаемая смена) пометка отметок, выходящих за её пределы. Возвращает рекомендацию: 'usable', 'review' или 'reject'.

Параметры
  • datestringобязательный

    Дата дежурства для отметок, YYYY-MM-DD.

  • dedupeSecondsinteger
  • expectedShiftobject

    Необязательное определение смены. Когда оно указано, отчет помечает отметки вне интервала [start - 4h, end + 4h] как внесменные.

  • punchesobject[]обязательный
evaluate_break_compliance

Анализирует соблюдение требований к перерывам для приема пищи и отдыха для рабочего дня по набору правил юрисдикции. v0.1 поставляется с пакетом California (Labor Code §§ 226.7, 512; IWC wage orders). Возвращает анализ по каждому приему пищи/отдыху, задолженные премиальные часы по обычной ставке, вопросы отказа и риск опровержимой презумпции согласно Donohue v. AMN.

Параметры
  • inputobjectобязательный

    Исходные данные за рассматриваемый день.

  • jurisdictionenumобязательный

    Встроенный пакет правил юрисдикции для применения. Пока только CA; в последующих минорных версиях появятся другие.

  • waiversobject[]
generate_roster

Генерирует сменный график на основе встроенного шаблона ('2-2-3', '4-on-4-off', 'dupont', 'pitman') или пользовательского дневного цикла. Возвращает одну смену на каждую календарную дату с меткой смены и временным окном в формате ЧЧ:ММ, или null в выходные дни.

Параметры
  • daysintegerобязательный
  • patternenum | objectобязательный
  • startDatestringобязательный
list_rule_packs

Перечисляет встроенные пакеты правил юрисдикций (соблюдение режима питания/отдыха). Возвращает каждый пакет с идентификатором, человекочитаемой меткой, источником цитирования и полными определениями правил.

Параметры

Без параметров.

resolve_day

Определяет один рабочий день на основе сырых отметок времени и определения смены. Возвращает структурированный DayResult: статус, отработанные минуты, опоздания, ранний уход, сверхурочные, обработку ночных смен, минуты за вычетом перерывов, флаги целостности данных и вычисленные сегменты входа/выхода.

Параметры
  • datestringобязательный

    Дата дежурства в местном времени рабочей площадки, YYYY-MM-DD.

  • holidayboolean
  • leaveobject | null
  • policyobject
  • punchesobject[]обязательный
  • shiftobjectобязательный
  • weekendboolean
resolve_period

Разрешает последовательность рабочих дней (неделя, расчётный период, месяц). Возвращает записи DayResult по дням; опционально включает агрегированный PeriodSummary с показателем посещаемости и количеством флагов.

Параметры
  • daysobject[]обязательный

    Входные данные для каждого дежурного дня за период.

  • summaryboolean

    Включает агрегированный PeriodSummary. По умолчанию: true.

0.1.0основная

Выберите клиент, чтобы установить arifur9993/attendance-engine-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"arifur9993-attendance-engine-mcp-2yyyb5m50e\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@attendance-engine/mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add arifur9993-attendance-engine-mcp-2yyyb5m50e -- npx -y @attendance-engine/mcp

Либо через JSON-конфиг:

claude mcp add-json arifur9993-attendance-engine-mcp-2yyyb5m50e "{\"command\":\"npx\",\"args\":[\"-y\",\"@attendance-engine/mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add arifur9993-attendance-engine-mcp-2yyyb5m50e -- npx -y @attendance-engine/mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.arifur9993-attendance-engine-mcp-2yyyb5m50e]
command = "npx"
args = ["-y", "@attendance-engine/mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите arifur9993/attendance-engine-mcp, а в поле команды запуска — строку ниже:
npx -y @attendance-engine/mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например arifur9993-attendance-engine-mcp-2yyyb5m50e.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: arifur9993-attendance-engine-mcp-2yyyb5m50e
    command: npx
    args:
      - "-y"
      - "@attendance-engine/mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "arifur9993-attendance-engine-mcp-2yyyb5m50e": {
      "command": "npx",
      "args": [
        "-y",
        "@attendance-engine/mcp"
      ]
    }
  }
}

Похожие MCP-сервера

Vaquill-AI/canlii-mcp

Vaquill-AI/canlii-mcp

от vaquill-ai

MCP-сервер для доступа к канадской правовой информации CanLII. Ищите судебные дела, законодательство и цитирования через единый API. Пригодится юристам, исследователям и разработчикам ИИ.

TypeScript⭐ 7
AlvisoOculus/optionsahoy-mcp

AlvisoOculus/optionsahoy-mcp

от alvisooculus

MCP сервер для детерминированного расчета налогов на акционерное вознаграждение: ISO, NSO, RSU, QSBS и концентрация акций. Точные цифры, а не оценка LLM. Полезен для планирования продаж и хеджирова...

TypeScript⭐ 5
AgentModule/mcp

AgentModule/mcp

от agentmodule

MCP-сервер предоставляет агентам детерминированные правила и директивы EU AI Act для runtime-проверки compliance, собирает audit-прозрачные доказательства и помогает избегать штрафов. Полезен разра...

JavaScript⭐ 2
PSU3D0/spreadsheet-mcp

PSU3D0/spreadsheet-mcp

от psu3d0

MCP сервер spreadsheet-kit даёт агентам безопасный и токен-эффективный способ работать с Excel-таблицами: читать, анализировать и изменять данные. Поддерживает dry-run, рекурсивный расчёт и поиск формул. Идеально для автоматизации работы с таблицами в агентных системах.

Rust⭐ 62
Patent-PreCheck/patent-precheck-mcp

Patent-PreCheck/patent-precheck-mcp

от patent-precheck

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

JavaScript⭐ 1
SoapyRED/freightutils-mcp

SoapyRED/freightutils-mcp

от soapyred

FreightUtils MCP сервер - нейтральные справочные данные для AI-агентов: ADR 2025, таможня, локации, расчет загрузки. 24 инструмента без привязки к перевозчику, данные от первоисточников.

TypeScript⭐ 7
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин