LeaveManager MCP Server

一个用于管理员工请假请求、余额和历史记录的模型上下文协议（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": "已申请1天的假期。剩余余额：17天。"
  }
}

错误响应

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "请假余额不足。所需：3天，可用：2天"
  }
}

许可证

本项目采用MIT许可证——详情见LICENSE文件。

更新日志

v1.0.0

• 初始发布
• 基本的请假管理功能
• 员工余额跟踪
• 请假申请系统
• 请假历史检索

---

注意：这是一个设计用于与AI助手和自动化工具配合工作的MCP（模型上下文协议）服务器。