使用说明
当然。这是您项目的完整README文件，记录了从安装到最终使用AI的整个过程。您可以将其直接复制并粘贴到 README.md GitHub存储库中的文件。
人力资源休假经理MCP服务器
这个项目是一个简单的、基于工具的服务器，使用 fastmcp 图书馆管理员工休假申请。它公开了人工智能模型可以使用的几个工具，如Anthropic的Claude，与模拟员工数据库进行交互。
特性
- ✅ 检查假期余额： 立即查看任何员工的剩余休假天数。
- ✅ 请假申请： 提交员工的休假申请，这会自动更新他们的余额。
- ✅ 查看休假历史记录： 检索员工过去休假日期的完整历史记录。
- ✅ 获取所有员工详细信息： 获取员工的完整记录，包括余额和历史记录。
⚙️ 设置和安装
按照以下步骤在新机器上设置项目。
1.先决条件
- 你必须有 Python 3.8+ 安装。
- 你必须有 克劳德桌面 安装。
- 你需要 紫外线，一个非常快的Python包安装程序。如果没有，请运行以下命令：
curl -LsSf [https://astral.sh/uv/install.sh](https://astral.sh/uv/install.sh) | sh
⚙️ 设置和安装
按照以下步骤在本地计算机上设置项目。
1.安装 uv
如果你没有 uv 安装后，在终端中运行以下命令：
curl -LsSf https://astral.sh/uv/install.sh | sh
（有关其他安装方法，请参阅 官方的 uv 文档.)
2.克隆存储库
将存储库克隆到本地计算机：
git clone <your-github-repo-url>
cd <your-repo-name>
3.安装依赖项
使用 uv 创建虚拟环境并安装所需的 fastmcp 包裹：
uv pip install fastmcp
🚀 用法
使用这个项目有两种主要方式：通过命令行进行本地测试，以及作为像克劳德这样的人工智能的工具服务器。
1.本地测试（交互式CLI）
这种方法用于快速测试函数的逻辑，而不需要人工智能。
A.开始互动环节： 运行以下命令在项目的虚拟环境中启动Python交互式会话（REPL）：
uv run python
您的提示将更改为 >>>.
B.导入并调用您的工具：
现在，您可以从以下位置导入函数 main.py 并直接给他们打电话。
# First, import the functions
>>> from main import get_leave_balance, apply_leave, get_employee_details
# Now, call them as needed
>>> get_leave_balance("E001")
'Employee E001 has 18 leave days remaining.'
>>> apply_leave("E002", ["2025-10-01"])
'✅ Leave approved for 1 day(s). New balance: 19.'
>>> get_employee_details("E002")
{'balance': 19, 'history': ['2025-10-01']}
要退出会话，请键入 exit().
2.使用人工智能客户端（克劳德桌面应用程序）运行
这是预期的用例，其中AI充当客户端。
A.提供代码：
复制您的全部内容 main.py 文件。
B.加上克劳德： 在Claude桌面应用程序中，将代码粘贴到提供工具或文件的部分。该平台将在后台运行脚本，使AI可以使用这些工具。
C.用自然语言提示AI： 现在，您可以要求Claude使用您的工具执行操作。例如：
- “员工E001还剩多少假期？”
- “向E003提交2025年7月20日的休假申请。”
- “显示员工E003的完整休假历史记录。”
🛠️ 工具概述
| 工具名称 | 描述 | 示例参数 |
|---|---|---|
apply_leave |
为特定员工申请一个或多个日期的休假。 | employee_id="E003", leave_dates=["2025-07-21"] |
get_leave_balance |
检查员工的剩余假期余额。 | employee_id="E001" |
get_leave_history |
获取特定员工的休假历史记录。 | employee_id="E002" |
get_employee_details |
获取员工的所有休假数据，包括余额和历史记录。 | employee_id="E003" |
