AI导哈

HR休假管理助手

一个基于MCP服务器的HR助手，用于管理员工休假（查询余额、申请休假、查看历史记录）。

  • by Subitha-Murugesan
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 subitha-murugesan/mcp-server

使用说明

第一个用于实际用例的MCP服务器一 人力资源休假管理助理.

概述：

  • 目标：构建一个 MCP服务器 这为A提供了动力 人力资源助理聊天机器人 管理员工休假（检查余额、申请、查看历史记录）。

建筑

  1. 数据库：离开数据库
  2. MCP服务器：基于Python的服务器使用 mcp SDK。
  3. 客户端：用途 克劳德桌面 （通用MCP客户端）而不是为了简单起见而使用自定义聊天机器人UI。

安装说明

安装工具：

  • pip install mcp –MCP SDK。
  • pip install uv UV是一个Python项目经理（就像Poetry一样）。
  • 克劳德桌面 –基于操作系统从官方网站下载。

初始化MCP项目：

uv init my-first-mcp-server
cd my-first-mcp-server

项目结构：

  • main.py：您的核心MCP服务器代码。
  • pyproject.toml：UV的元数据/配置。

模拟数据库示例

mock_db = {
    "E001": {"balance": 18, "leaves_taken": ["2024-12-25", "2025-01-01"]},
    "E002": {"balance": 20, "leaves_taken": []}
}

MCP服务器代码设计

  • 导入 FastMCP 类。

  • 创建工具：

    • get_leave_balance(employee_id)
    • apply_leave(employee_id, leave_dates)
    • get_leave_history(employee_id)

  • 添加a 资源 问候的工具。

关键提示：写 详细文档字符串 --它们对于基于LLM的工具选择至关重要。

运行服务器

uv mcp install main.py
  • 注册服务器（例如。， leave-manager)在克劳德的配置中。

Claude桌面集成

  • 打开克劳德桌面。
  • 启用 开发人员模式 （对于查看自定义工具很重要）。
  • 首选 File → 设置→ 开发者.
  • 编辑配置以验证MCP服务器(leave-manager)已正确注册。

使用助手（克劳德桌面）

  • 问： “E001有几片叶子？”

    • 电话： get_leave_balance("E001")

  • 问： “给我看同一个人的休假日期。”

    • 维护上下文(E001) → 电话： get_leave_history("E001")

  • 问： “7月4日申请E002休假。”

    • 电话： apply_leave("E002", ["2025-07-04"])

Claude解释自然语言，映射到正确的工具，并智能地填充参数。

故障排除提示

如果出现以下错误 type str 发生：

pip install --upgrade typer

相关 MCP