Darwinbox MCP

Darwinbox HRMS MCP服务器

用于与Darwinbox HRMS API交互的模型上下文协议（MCP）服务器。此服务器通过标准化界面提供管理员工数据、考勤和休假管理的工具。

演示

Demo

特性

核心工具

• 员工管理

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

时间管理工具

• 考勤管理

- 获得每月出勤率 - 获得每日出勤率 - 获取考勤表 - 出勤率创纪录 - 记录回溯出勤情况

• 休假管理

- 批准休假 - 获取休假操作历史记录 - 获取假期列表 - 获取假期余额 - 进口树叶

安装

1. 克隆存储库：

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

1. 安装依赖项：

npm install

1. 构建项目：

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进行身份验证。它会自动处理：

1. 使用提供的凭据获取令牌
2. 代币管理和更新
3. 具有正确标头的经过身份验证的API请求

错误处理

服务器为以下对象提供详细的错误消息：

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

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。