使用MCP的人力资源助理
基于AI的人力资源助理 模型上下文协议(MCP)它将人力资源管理操作作为MCP工具公开,允许人工智能助理(如克劳德)通过自然语言管理员工、休假、会议和It票证。
特性
- 员工管理:添加员工、按姓名搜索、查看详细信息、获取经理/直接下属
- 休假管理:查看休假余额、申请休假、查看休假历史记录
- 会议管理:安排和取消会议
- IT票务管理:提出并跟踪设备/采购请求
- 电子邮件:通过Gmail SMTP发送真实电子邮件(欢迎电子邮件、通知)
- 登机提示:内置提示,将所有工具端到端地链接到新员工
设置
1.克隆仓库
git clone
cd hr-assist-using-mcp2.安装依赖项
需要Python 3.13以上。用途 紫外线 用于包管理。
uv sync3.配置环境变量
复制 sample.env 到 .env 并填写您的Gmail凭据:
cp sample.env .envCB_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发送电子邮件 |
