HourLedger — Work Hours & Overtime Calculator について
HourLedgerは、労働時間、残業時間、総支給額を計算するMCPサーバーです。米国の連邦・州ルールに基づく計算が必要な人事や給与業務向けで、夜間シフトや丸め方などを設定できます。
主な機能
- 01労働時間と総支給額の計算
- 02連邦および4州のルールセット
- 03夜間シフトへの対応
- 04丸め方と週の開始日の設定
- 051.5倍の残業代計算
活用シーン
- 01打刻記録から週給を計算
- 02州のルールに基づく残業時間の確認
- 03時給と残業時間から残業代を算出
MCP 対応
MCPクライアントに`calculate_work_hours`と`time_and_a_half`のツールを提供します。前者は通常・残業・倍額対象時間の内訳と総支給額を返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
2掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| entries | array | はい | |
| hourlyRate | number | はい | |
| ruleset | enum | いいえ | federal | california | alaska | colorado | nevada |
| workweekStart | integer | いいえ | 0=日曜日 … 6=土曜日 |
| rounding | enum | いいえ | none | nearest_5 | nearest_15 | nearest_tenth |
| nvDailyOt | boolean | いいえ | ネバダ州のみ:率に基づく日次残業の適格性チェックを上書きします |
詳細
hourledger-mcp
勤務時間、時間外労働、総支給額を計算するMCPサーバーです。HourLedgerを支える、テスト済みの同じルールエンジンを利用しています。HourLedgerは、登録不要で無料の勤務時間計算ツールを提供するサービスです。
ツール
calculate_work_hours
出退勤時刻(無給の休憩を含む)、時給、ルールセットを受け取り、日ごとおよび合計の通常勤務/時間外労働/ダブルタイムの内訳と総支給額を返します。
以下のルールセットに対応しており、すべて自動テストスイートで検証されています。
| ルールセット | ルール |
|---|---|
federal | 週40時間を超えると1.5倍(FLSA) |
california | 1日8時間を超えると1.5倍、1日12時間を超えると2倍、7日目のルール、重複適用なし(Labor Code §510) |
alaska | 1日8時間または週40時間を超えると1.5倍(AS 23.10.060) |
colorado | 1日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**で利用できます。
- 勤務時間と時間外労働 · 時間外労働 · 1.5倍の時給
- カリフォルニア州 · アラスカ州 · コロラド州 · ネバダ州
- 自分のサイトに計算ツールを埋め込む
免責事項
一般的な情報であり、法律上または給与計算上の助言ではありません。適用除外や地域ごとのルールは異なる場合があります。賃金に異議がある場合は、州の労働機関または資格を持つ専門家にご確認ください。
開発
給与ルールエンジン(src/engine.tsとその27件のテスト)は、ルールの変更が最初に反映されるHourLedgerサイトプロジェクトと同じ内容です。npm testでテストスイート全体を実行できます。prepublishOnlyにより、公開前にテストとビルドが必ず実行されます。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。