使用说明

LeaveManager MCP服务器

用于管理员工休假请求、余额和历史记录的模型上下文协议（MCP）服务器。该服务器通过标准化的API端点提供了一种简单高效的方法来处理休假管理操作。

特性

休假余额管理：检查员工的剩余休假天数
请假申请：在特定日期申请休假
离开历史：查看员工的完整休假历史记录
日期范围支持：申请多个连续或非连续休假日期
实时余额更新：休假申请后自动更新余额

可用功能

1.获得假期余额

检查特定员工的剩余休假天数。

{
  "function": "get_leave_balance",
  "parameters": {
    "employee_id": "string"
  }
}

响应：返回员工剩余的休假天数。

2.申请休假

提交特定日期的休假申请。

{
  "function": "apply_leave",
  "parameters": {
    "employee_id": "string",
    "leave_dates": ["2025-06-03", "2025-06-04"]
  }
}

响应：确认休假申请并返回更新的余额。

3.获取休假历史记录

检索员工的完整休假历史记录。

{
  "function": "get_leave_history",
  "parameters": {
    "employee_id": "string"
  }
}

响应：按时间顺序返回所有休假申请及其状态的列表。

使用示例

检查假期余额

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "get_leave_balance",
    "params": {
      "employee_id": "E001"
    }
  }'

申请一天假

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "apply_leave",
    "params": {
      "employee_id": "E001",
      "leave_dates": ["2025-06-03"]
    }
  }'

申请多天假期

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "apply_leave",
    "params": {
      "employee_id": "E001",
      "leave_dates": ["2025-06-03", "2025-06-04", "2025-06-05"]
    }
  }'

日期格式

所有日期应以ISO 8601格式提供： YYYY-MM-DD

示例：

2025-06-03 （2025年6月3日）
2025-12-25 （2025年12月25日）

错误处理

服务器为常见场景提供详细的错误响应：

员工ID无效：如果员工不存在，则返回错误
假期余额不足：如果剩余天数不足，则阻止休假申请
日期格式无效：返回格式错误的日期错误
过去日期申请：阻止申请过去的日期
重复休假申请：阻止申请已批准的日期

API响应格式

成功响应

{
  "success": true,
  "data": {
    "message": "Leave applied for 1 day(s). Remaining balance: 17."
  }
}

错误响应

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient leave balance. Required: 3, Available: 2"
  }
}

许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

更新日志

v1.0.0

初始版本
基本休假管理功能
员工余额跟踪
休假申请系统
离开历史检索