leave-pto-requests-approvals

mcp-leave

已收录于 官方 MCP Registry（io.github.theluckystrike/leave）。 为个体经营者和小型工作室提供员工休假/PTO 跟踪：谁在休假、何时休假，以及每个人还剩多少天。添加员工并设置年度额度和任何结转天数，记录年假、病假和个人假申请（包括半天），批准或拒绝申请，并可直接从 MCP 客户端（如 Claude Desktop、Cursor 或任何 MCP 主机）查看余额、冲突和休假日历。

工具

• "leave_employee_add" - 添加员工，并设置 annualAllowance（以及可选的 carriedOver）。
• "leave_request" - 记录休假申请（employee、type、start、end，以及可选的 halfDay、reason）。
• "leave_approve" / "leave_reject" - 决定是否批准申请；决策会连同日期一并记录。
• "leave_cancel" - 取消待处理或已批准的申请（保留审计记录）。
• "leave_balance" - 查看每位员工的额度、结转天数、已批准天数、待处理天数、已占用天数和剩余天数。
• "leave_out_range" - 查看某个日期范围内谁在休假：逐日列出的日历行及人天数。
• "leave_list" - 列出所有员工和申请，可按员工和状态筛选。
• "leave_import"（Pro）- 从 CSV 批量创建申请；冲突行会逐条拒绝，有效行仍会导入。
• "leave_export_ics"（Pro）- 将已批准的休假导出为 RFC5545 .ics 日历。

唯一决定其他一切的规则

申请所占用的假期在已批准或待处理时即视为已占用。 余额 = allowance + carried − approved − pending。取消申请后，天数会立即返还；拒绝申请则不会扣除天数。

同一个人的重叠申请会在创建时被拒绝——待处理和已批准的申请都会计入，因此日历中不会出现两个申请占用同一天的情况。

免费版与 Pro 版

免费版提供完整的 CRUD 功能：员工、申请、审批、余额和日历——无水印，也没有申请数量限制。Pro 版（MCP_LICENSE_KEY，通过 "license_activate" 激活）增加 CSV 批量导入和 ICS 日历导出。运行 "license_status" 可查看当前版本。

快速开始

{
  "mcpServers": {
    "leave": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-leave"] }
  }
}

数据存储在单个 JSON 文件（~/.mcp-leave/store.json；若已设置，则为 $XDG_DATA_HOME/mcp-servers/leave/store.json）中，并在文件锁保护下以原子方式写入，因此同一台机器上的两个客户端不会交错写入。

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此代码库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-leave