使用说明
人力资源管理局特工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"
}
}
}
}