HRMS代理工具

一个基于MCP协议的人力资源管理系统,提供员工管理、通讯、票务系统、会议安排、休假管理等功能,适用于AI助手集成。

  • by mayankiet
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mayankiet/hrms-agent-mcp

使用说明

人力资源管理局特工mcp

A. 模型上下文协议(MCP)-启用了人力资源管理系统(HRMS)项目,该项目将人力资源工作流程作为可调用工具,供Claude Desktop等代理人工智能助理使用。

该项目在Python中实现了一个MCP服务器,允许AI代理管理员工、门票、会议、假期余额和发送电子邮件——所有这些都是通过定义的MCP工具实现的。


🚀 特性

此HRMS MCP服务器支持以下工具调用:

👩‍💼 员工管理

  • add_employee(emp_name, manager_id, email) --添加新员工
  • get_employee_details(name) --按姓名获取员工详细信息

📨 沟通

  • send_email(to_emails, subject, body, html) --发送电子邮件通知

🎟 票务系统

  • create_ticket(emp_id, item, reason) --创建服务/资产请求
  • update_ticket_status(ticket_id, status) --更新票证状态
  • list_tickets(employee_id, status) --列出员工票

📅 会议

  • schedule_meeting(employee_id, meeting_datetime, topic) --安排会议
  • get_meetings(employee_id) --召开员工会议
  • cancel_meeting(employee_id, meeting_datetime, topic) --取消会议

🌴 休假和休息时间

  • get_employee_leave_balance(emp_id) --获取假期余额
  • apply_leave(emp_id, leave_dates) --申请休假
  • get_leave_history(emp_id) --获取休假历史记录

🧠 登机提示

  • onboard_new_employee(employee_name, manager_name) --快速定义以自动化常见的入职步骤

🧩 项目结构

├── .env#环境变量(未跟踪) ├── hrms#hrms业务逻辑 ├── emails.py#电子邮件助手逻辑 ├── server.py#MCP服务器和工具定义 ├── utils.py#实用函数 ├── main.py#入口点示例脚本 ├── pyproject.toml#Python项目配置 ├── README.md#项目文档 └── uv.lock#uv依赖锁


⚙️ 设置

1.克隆存储库

git clone https://github.com/mayankiet/hrms-agent-mcp.git
cd hrms-agent-mcp

2. Install dependencies
uv init
uv install


3.  Create .env file

Create a .env with your email credentials:

CB_EMAIL=youremail@example.com
CB_EMAIL_PWD=yourpassword


Run MCP Server

To launch the MCP server:

uv run server.py



Connect to Claude Desktop

Open Claude Desktop

Go to Settings → Developer → Edit Config

Add:

{
  "mcpServers": {
    "hrms-agent-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/FULL/PATH/TO/hrms-agent-mcp",
        "run",
        "server.py"
      ],
      "env": {
        "CB_EMAIL": "youremail@example.com",
        "CB_EMAIL_PWD": "yourpassword"
      }
    }
  }
}