LeaveManager MCP Server

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 许可证授权，详情请参阅 LICENSE 文件。

更新日志

v1.0.0

• 首次发布
• 基本请假管理功能
• 员工余额跟踪
• 请假申请系统
• 请假历史记录检索

---

注意：这是一个 MCP（模型上下文协议）服务，旨在与 AI 助手和自动化工具配合使用。