First Mcp Server

#请假管理系统 这是一个使用 Python 中的 FastMCP 框架构建的简单请假管理系统。员工可以查询剩余假期、申请特定日期的假期、查看请假历史记录，并接收个性化问候。系统使用内存中的模拟数据库存储员工请假数据。 功能

查询剩余假期：获取员工剩余的假期天数。 申请请假：申请特定日期的假期，并验证假期余额。 查看请假历史：查看员工此前请假的日期。 个性化问候：获取为用户定制的问候消息。

前置条件

Python 3.8 或更高版本 FastMCP 库（确保已安装或可在你的环境中使用）

安装依赖（如果 FastMCP 可通过 pip 安装）： pip install fastmcp

安装

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

用法

运行服务：将代码保存到文件中（例如 leave_manager.py），然后运行： python leave_manager.py

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

与服务交互：使用兼容 FastMCP 的客户端界面（例如 API 调用、CLI 或 UI）发送以下命令：

查询剩余假期：get_leave_balance("E001") 示例响应：E001 还剩 18 天假期。

申请请假：apply_leave("E002", ["2025-04-17", "2025-04-18"]) 示例响应：已申请 2 天假期。剩余假期：18 天。

获取请假历史：get_leave_history("E001") 示例响应：E001 的请假历史：2024-12-25, 2025-01-01

获取问候：greeting://Alice 示例响应：你好，Alice！今天我能如何协助你管理请假事宜？

模拟数据库 系统使用内存中的字典（employee_leaves）作为模拟数据库，初始化数据如下：

员工 E001：18 天假期，历史记录：["2024-12-25", "2025-01-01"] 员工 E002：20 天假期，历史记录：[]

注意：数据仅在服务运行期间保留。重启服务后，数据会重置为初始状态。 代码结构

FastMCP 服务：使用 FastMCP("LeaveManager") 创建服务。 工具： get_leave_balance(employee_id: str)：返回剩余假期天数。 apply_leave(employee_id: str, leave_dates: List[str])：为指定日期申请假期。 get_leave_history(employee_id: str)：获取请假历史记录。

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

限制

内存存储：服务重启后数据不会保留。 日期验证：系统不会验证日期格式，也不会检查重复的请假日期。 可扩展性：采用模拟数据库，适用于小规模使用。 错误处理：仅对员工 ID 和假期余额进行基本检查；用于生产环境时可能需要添加额外验证。

未来改进

为员工数据添加持久化存储（例如 SQLite 或 MongoDB）。 实现日期格式验证，并防止重复提交请假申请。 添加身份验证，以保护员工数据访问。 支持批量请假申请或取消请假。 集成易于使用的前端，以便更轻松地进行交互。

测试 使用以下示例提示词测试系统：

为 {EID} 申请日期为 {} 的假期 获取 {EID} 的请假历史 获取 (EID} 的假期余额

确保服务正在运行，并使用兼容的客户端发送这些请求。 许可证 本项目仅用于演示，不附带特定许可证。你可以根据自己的使用场景按需修改和使用。 联系 如有问题或希望贡献，请联系项目维护者，或在代码库中提交问题（如适用）。