使用说明
Darwinbox HRMS MCP服务器
用于与Darwinbox HRMS API交互的模型上下文协议(MCP)服务器。此服务器通过标准化界面提供管理员工数据、考勤和休假管理的工具。
演示
特性
核心工具
- 员工管理
- 获取员工详细信息(单个、多个或所有员工)
- 更新员工信息
- 添加新员工
- 停用员工
- 下载个人文档
- 获取员工历史记录
- 获取岗位主数据
- 获取表单数据
- 获取分离细节
- 上传个人资料附件
时间管理工具
- 考勤管理
- 获得每月出勤率
- 获得每日出勤率
- 获取考勤表
- 出勤率创纪录
- 记录回溯出勤情况
- 休假管理
- 批准休假
- 获取休假操作历史记录
- 获取假期列表
- 获取假期余额
- 进口树叶
安装
- 克隆存储库:
git clone https://github.com/prithvidbox/darwinbox-mcp
cd darwinbox-server
- 安装依赖项:
npm install
- 构建项目:
npm run build
MCP客户端配置
Claude桌面客户端
{
"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": []
}
}
}
临床配置
{
"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"
}
}
}
}
光标配置
{
"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"
}
}
}
}
认证
服务器使用OAuth 2.0进行身份验证。它会自动处理:
- 使用提供的凭据获取令牌
- 代币管理和更新
- 具有正确标头的经过身份验证的API请求
错误处理
服务器为以下对象提供详细的错误消息:
- 配置缺失或无效
- 身份验证失败
- API请求无效
- API响应错误
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
