🚀 Darwinbox HRMS MCP 服务器
Darwinbox HRMS MCP 服务器是一个用于与 Darwinbox HRMS API 交互的模型上下文协议 (MCP) 服务器。它提供了管理员工数据、考勤和请假管理的标准接口工具，极大地方便了 HR 相关业务的开展。
🚀 快速开始
安装指南
- 克隆仓库：
git clone https://github.com/prithvidbox/darwinbox-mcp
cd darwinbox-server
- 安装依赖项：
npm install
- 构建项目：
npm run build
MCP 客户端配置
Claude Desktop Client 配置
{
"mcpServers": {
"darwinbox": {
"command": "node",
"args": ["path/to/darwinbox-server/build/index.js"],
"env": {
"DARWINBOX_DOMAIN": "https://your-domain.darwinbox.in",
"DARWINBOX_CLIENT_ID": "your-client-id",
"DARWINBOX_CLIENT_SECRET": "your-client-secret",
"DARWINBOX_GRANT_TYPE": "authorization_code",
"DARWINBOX_CODE": "your-auth-code",
"DARWINBOX_DATASET_KEY": "your-dataset-key"
},
"disabled": false,
"autoApprove": []
}
}
}
Cline 配置
{
"servers": {
"darwinbox": {
"command": "node",
"args": ["path/to/darwinbox-server/build/index.js"],
"env": {
"DARWINBOX_DOMAIN": "https://your-domain.darwinbox.in",
"DARWINBOX_CLIENT_ID": "your-client-id",
"DARWINBOX_CLIENT_SECRET": "your-client-secret",
"DARWINBOX_GRANT_TYPE": "authorization_code",
"DARWINBOX_CODE": "your-auth-code",
"DARWINBOX_DATASET_KEY": "your-dataset-key"
}
}
}
}
Cursor 配置
{
"mcpServers": {
"darwinbox": {
"command": "node",
"args": ["path/to/darwinbox-server/build/index.js"],
"env": {
"DARWINBOX_DOMAIN": "https://your-domain.darwinbox.in",
"DARWINBOX_CLIENT_ID": "your-client-id",
"DARWINBOX_CLIENT_SECRET": "your-client-secret",
"DARWINBOX_GRANT_TYPE": "authorization_code",
"DARWINBOX_CODE": "your-auth-code",
"DARWINBOX_DATASET_KEY": "your-dataset-key"
}
}
}
}
✨ 主要特性
核心工具
- 员工管理
- 获取员工详细信息（单个、多个或所有员工）
- 更新员工信息
- 添加新员工
- 停用员工
- 下载个人文档
- 获取员工历史记录
- 获取职位主数据
- 获取表单数据
- 获取离职详情
- 上传个人资料附件
考勤管理工具
- 考勤管理
- 获取月度考勤记录
- 获取每日考勤记录
- 获取排班考勤 roster
- 记录考勤打卡
- 记录追溯性考勤
- 请假管理
- 审批请假申请
- 获取请假操作历史
- 获取假期列表
- 获取请假余额
- 导入请假记录
🔍 演示
🔧 技术细节
认证
服务器使用 OAuth 2.0 进行认证。它自动处理：
- 使用提供的凭证获取令牌
- 令牌管理和续订
- 带有适当头信息的认证 API 请求
错误处理
服务器提供详细的错误消息，包括：
- 配置缺失或无效
- 认证失败
- 无效的 API 请求
- API 响应错误
📄 许可证
此项目根据 MIT 许可证发布，详细信息请参阅 LICENSE 文件。