HourLedger — Work Hours & Overtime Calculator

hourledger-mcp

一个 MCP 服务，用于计算工时、加班时长和税前工资——采用与 HourLedger 相同且经过测试的规则引擎。HourLedger 是一套免费的工时计算器，无需注册即可使用。

工具

calculate_work_hours

输入上下班打卡记录（含无薪休息时间）、时薪和规则集；返回每天及总计的正常工时、加班工时和双倍工时明细，以及税前工资。

支持以下规则集，均由自动化测试套件覆盖：

规则集	规则
federal	每周超过 40 小时的部分按 1.5 倍计算（FLSA）
california	每天超过 8 小时的部分按 1.5 倍计算，超过 12 小时的部分按 2 倍计算；适用第 7 天规则，不重复计算（Labor Code §510）
alaska	每天超过 8 小时或每周超过 40 小时的部分按 1.5 倍计算（AS 23.10.060）
colorado	每天超过 12 小时或每周超过 40 小时的部分按 1.5 倍计算（COMPS Order）
nevada	仅当时薪低于最低工资的 1.5 倍时，适用每日 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 美元，在 Nevada。”

模型会用 4 条 10 小时的记录调用 calculate_work_hours，并返回正确的 Nevada 计算结果（19 美元 ≥ 18 美元门槛 → 仅适用每周规则 → 40 小时正常工时，无加班），以及逐日明细。

交互式计算器

更喜欢使用界面？每种规则集都提供免费的计算器，无需注册，可访问 hourledger.com：

• 工时和加班 · 加班 · 1.5 倍时薪
• California · Alaska · Colorado · Nevada
• 在你自己的网站上嵌入计算器

免责声明

本文仅提供一般信息，不构成法律或薪资建议。豁免情形和地方法规各不相同；如对工资有争议，请向所在州的劳工机构或合格的专业人士核实。

开发

薪资规则引擎（src/engine.ts 及其 27 项测试）与 HourLedger 网站项目中的版本保持同步，规则更新会先在那里发布。运行 npm test 可执行完整测试套件；prepublishOnly 会在每次发布前强制执行测试和构建。

许可证

MIT