请假管理系统

一个基于FastMCP框架的Python请假管理系统,允许员工查看假期余额、申请休假、查看休假历史并接收个性化问候。

  • by Pavan-Aditya-Kumar-Gorrela
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 pavan-aditya-kumar-gorrela/first-mcp-server

使用说明

#休假管理制度 这是一个使用Python中的FastMCP框架构建的简单休假管理系统。它允许员工查看他们的假期余额,在特定日期申请假期,查看他们的休假历史记录,并收到个性化的问候。该系统使用内存中的模拟数据库来存储员工休假数据。 特性

检查休假余额:检索员工的剩余休假天数。 申请休假:申请特定日期的休假,并进行余额验证。 查看休假历史:查看员工之前休假的日期。 个性化问候:为用户获取自定义问候信息。

先决条件

Python 3.8或更高版本 FastMCP库(确保在您的环境中已安装或可用)

要安装依赖项(如果FastMCP可通过pip获得): pip安装fastmcp

安装

将项目文件克隆或下载到本地计算机。 确保安装了Python和所需的依赖项。 将主脚本(例如leave_manager.py)放置在您的工作目录中。

用法

运行服务器:将代码保存在文件中(例如leave_manager.py)并运行它: python leave_manager.py

这将启动名为LeaveManager的FastMCP服务器。

与服务器交互:使用与FastMCP兼容的客户端接口(例如,API调用、CLI或UI)发送以下命令:

检查假期余额:get_Leave_Balance(“E001”) 示例响应:E001还有18天的假期。

请假申请:请假申请(“E002”,[“2025-04-17”,“2025-04-18”]) 示例回复:申请休假2天。余额:18。

获取休假历史记录:Get_Leave_History(“E001”) 示例响应:为E001:2024-12-252025-01-01留下历史记录

获得问候:greeting://Alice 示例回复:你好,爱丽丝!今天我如何协助您进行休假管理?

模拟数据库 系统使用内存中的字典(employee_leaves)作为模拟数据库,初始化为:

员工E001:18天休假,历史:[“2024-12-25”,“2025-01-01”] 员工E002:20天休假,历史记录:[]

注意:数据仅在服务器运行时保留。重新启动服务器会将数据重置为初始状态。 编码结构

FastMCP服务器:该服务器是使用FastMCP(“LeaveManager”)创建的。 工具: get_leave_balance(employee_id:str):返回剩余的休假天数。 apply_live(employee_id:str,leave_dates:List[str]):在指定日期申请休假。 get_leave_history(employee_id:str):检索休假历史。

资源: get_greeting(name:str):通过greeting://{name}返回个性化问候语。

局限性

内存存储:数据在服务器重启后不会持久化。 日期验证:系统不会验证日期格式或检查重复的休假日期。 可扩展性:专为模拟数据库的小规模使用而设计。 错误处理:对员工ID和假期余额进行基本检查;生产使用可能需要额外的验证。

未来改进

为员工数据添加持久存储(例如SQLite或MongoDB)。 实施日期格式验证,防止重复请假。 添加身份验证以保护员工数据访问。 支持批量休假申请或取消休假。 集成用户友好的前端,以实现更轻松的交互。

测试 要测试系统,请使用以下示例提示:

Appy离开{EID}的日期{} 获取{EID}的休假历史记录 获取(EID)的假期余额

确保服务器正在运行,并使用兼容的客户端发送这些请求。 许可证 此项目用于演示目的,不包括特定的许可证。根据您的用例需要进行修改和使用。 联系 对于问题或贡献,请联系项目维护人员或在存储库中打开问题(如果适用)。