Darwinbox HRMS MCP Server

Darwinbox HRMS MCP Server

一个用于与 Darwinbox HRMS API 交互的模型上下文协议（MCP）服务。此服务提供标准化接口，用于管理员工数据、考勤和休假。

演示

功能

核心工具

• 员工管理
  • 获取员工详情（单个、多个或所有员工）
  • 更新员工信息
  • 添加新员工
  • 停用员工
  • 下载个人文档
  • 获取员工历史记录
  • 获取职位主数据
  • 获取表单数据
  • 获取离职详情
  • 上传个人资料附件

时间管理工具

• 考勤管理
  • 获取月度考勤
  • 获取每日考勤
  • 获取考勤排班表
  • 记录考勤打卡
  • 记录补录考勤
• 休假管理
  • 批准休假
  • 获取休假操作历史记录
  • 获取假期列表
  • 获取休假余额
  • 导入休假

安装

1. 克隆仓库：

git clone https://github.com/prithvidbox/darwinbox-mcp
cd darwinbox-server

2. 安装依赖项：

npm install

3. 构建项目：

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": []
    }
  }
}

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"
      }
    }
  }
}

身份验证

服务使用 OAuth 2.0 进行身份验证，并会自动处理：

1. 使用提供的凭据获取令牌
2. 管理和续期令牌
3. 使用适当的标头发送经过身份验证的 API 请求

错误处理

服务会针对以下情况提供详细的错误消息：

• 配置缺失或无效
• 身份验证失败
• API 请求无效
• API 响应错误

许可证

本项目基于 MIT 许可证授权，详情请参阅 LICENSE 文件。