mcpField
H
HourLedger — Work Hours & Overtime Calculator

HourLedger — Work Hours & Overtime Calculator

ローカル
hourledger.com金融データ218 週間前に更新

HourLedger — Work Hours & Overtime Calculator について

HourLedgerは、労働時間、残業時間、総支給額を計算するMCPサーバーです。米国の連邦・州ルールに基づく計算が必要な人事や給与業務向けで、夜間シフトや丸め方などを設定できます。

主な機能

  1. 01労働時間と総支給額の計算
  2. 02連邦および4州のルールセット
  3. 03夜間シフトへの対応
  4. 04丸め方と週の開始日の設定
  5. 051.5倍の残業代計算

活用シーン

  1. 01打刻記録から週給を計算
  2. 02州のルールに基づく残業時間の確認
  3. 03時給と残業時間から残業代を算出

MCP 対応

MCPクライアントに`calculate_work_hours`と`time_and_a_half`のツールを提供します。前者は通常・残業・倍額対象時間の内訳と総支給額を返します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"hourledger": {
"command": "npx",
"args": [
"-y",
"hourledger-mcp"
]
}
}
}
起動コマンドnpx -y hourledger-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmhourledger-mcp1.0.2

ツール

2

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
entriesarrayはい
hourlyRatenumberはい
rulesetenumいいえfederal | california | alaska | colorado | nevada
workweekStartintegerいいえ0=日曜日 … 6=土曜日
roundingenumいいえnone | nearest_5 | nearest_15 | nearest_tenth
nvDailyOtbooleanいいえネバダ州のみ:率に基づく日次残業の適格性チェックを上書きします

詳細

hourledger-mcp

勤務時間、時間外労働、総支給額を計算するMCPサーバーです。HourLedgerを支える、テスト済みの同じルールエンジンを利用しています。HourLedgerは、登録不要で無料の勤務時間計算ツールを提供するサービスです。

ツール

calculate_work_hours

出退勤時刻(無給の休憩を含む)、時給、ルールセットを受け取り、日ごとおよび合計の通常勤務/時間外労働/ダブルタイムの内訳と総支給額を返します。

以下のルールセットに対応しており、すべて自動テストスイートで検証されています。

ルールセットルール
federal週40時間を超えると1.5倍(FLSA)
california1日8時間を超えると1.5倍、1日12時間を超えると2倍、7日目のルール、重複適用なし(Labor Code §510)
alaska1日8時間または週40時間を超えると1.5倍(AS 23.10.060)
colorado1日12時間または週40時間を超えると1.5倍(COMPS Order)
nevada時給が最低賃金の1.5倍未満の場合に限り、1日8時間のルールを適用 — 時給に基づいて自動判定(NRS 608.018)

深夜をまたぐシフト、入力ごとの丸め方式(正確な時間/5分単位/15分単位/0.1時間単位)、設定可能な週の開始曜日に対応しています。

time_and_a_half

時給と時間外労働時間から、1.5倍の時給と時間外労働分の賃金をすばやく計算します。

セットアップ

Claude Desktop / Claude Code
{
  "mcpServers": {
    "hourledger": {
      "command": "npx",
      "args": ["-y", "hourledger-mcp"]
    }
  }
}

または、Claude Code で次を実行します:claude mcp add hourledger -- npx -y hourledger-mcp

使用例

「今週の賃金はいくらですか?ネバダ州で月曜日から木曜日まで、午前7時から午後5時まで、時給19ドルで働きました。」

モデルは4件の10時間勤務を指定してcalculate_work_hoursを呼び出し、ネバダ州の正しい計算結果(19ドル ≥ 18ドルの基準額 → 週単位のルールのみ適用 → 通常勤務40時間、時間外労働なし)と、日ごとの詳細を取得します。

インタラクティブ計算ツール

UI を使いたいですか?各ルールセットに対応した、登録不要で無料の計算ツールを**hourledger.com**で利用できます。

免責事項

一般的な情報であり、法律上または給与計算上の助言ではありません。適用除外や地域ごとのルールは異なる場合があります。賃金に異議がある場合は、州の労働機関または資格を持つ専門家にご確認ください。

開発

給与ルールエンジン(src/engine.tsとその27件のテスト)は、ルールの変更が最初に反映されるHourLedgerサイトプロジェクトと同じ内容です。npm testでテストスイート全体を実行できます。prepublishOnlyにより、公開前にテストとビルドが必ず実行されます。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。