darwinbox-mcp

🚀 Darwinbox HRMS MCP 服务器

Darwinbox HRMS MCP 服务器是一个用于与 Darwinbox HRMS API 交互的模型上下文协议 (MCP) 服务器。它提供了管理员工数据、考勤和请假管理的标准接口工具，极大地方便了 HR 相关业务的开展。

🚀 快速开始

安装指南

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

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 进行认证。它自动处理：

1. 使用提供的凭证获取令牌
2. 令牌管理和续订
3. 带有适当头信息的认证 API 请求

错误处理

服务器提供详细的错误消息，包括：

• 配置缺失或无效
• 认证失败
• 无效的 API 请求
• API 响应错误

📄 许可证

此项目根据 MIT 许可证发布，详细信息请参阅 LICENSE 文件。