AI导哈

HR管理助手

基于模型上下文协议（MCP）的AI人力资源助手，通过自然语言管理员工、休假、会议和IT工单。

  • by kushalsamani
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kushalsamani/HR-Assist-using-MCP-Server

使用说明

使用MCP的人力资源助理

基于AI的人力资源助理 模型上下文协议（MCP）它将人力资源管理操作作为MCP工具公开，允许人工智能助理（如克劳德）通过自然语言管理员工、休假、会议和It票证。

特性

  • 员工管理：添加员工、按姓名搜索、查看详细信息、获取经理/直接下属
  • 休假管理：查看休假余额、申请休假、查看休假历史记录
  • 会议管理：安排和取消会议
  • IT票务管理：提出并跟踪设备/采购请求
  • 电子邮件：通过Gmail SMTP发送真实电子邮件（欢迎电子邮件、通知）
  • 登机提示：内置提示，将所有工具端到端地链接到新员工

设置

1.克隆仓库

git clone <repo-url>
cd hr-assist-using-mcp

2.安装依赖项

需要Python 3.13以上。用途 紫外线 用于包管理。

uv sync

3.配置环境变量

复制 sample.env 到 .env 并填写您的Gmail凭据：

cp sample.env .env

CB_EMAIL=your_gmail@gmail.com
CB_EMAIL_PWD=your_app_password

使用一个 Gmail应用密码，不是您的常规Gmail密码。

4.连接到克劳德桌面

将以下内容添加到您的Claude Desktop MCP配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "hr-assist": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/hr-assist-using-mcp"
    }
  }
}

项目结构

hr-assist-using-mcp/
├── server.py          # MCP server — registers all tools and prompts
├── utils.py           # Seeds in-memory stores with dummy data
├── emails.py          # Gmail SMTP email sender
├── hrms/
│   ├── schemas.py         # Pydantic models
│   ├── employee_manager.py
│   ├── leave_manager.py
│   ├── meeting_manager.py
│   └── ticket_manager.py
├── sample.env         # Template for environment variables
└── pyproject.toml

可用的MCP工具

工具 说明
add_employee 添加新员工
get_employee_details 按姓名查找员工
get_employee_leave_balance 检查剩余休假天数
apply_leave 在指定日期申请休假
get_leave_history 查看过去的休假记录
schedule_meeting 安排会议
get_meetings 列出即将举行的会议
cancel_meeting 取消已安排的会议
create_ticket 提出IT/设备票
update_ticket_status 更新票证状态
list_tickets 列出带有可选过滤器的门票
send_email 通过Gmail发送电子邮件

相关 MCP