HRMS员工管理协议服务器

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

  • by prithvidbox
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 prithvidbox/darwinbox-mcp

使用说明

Darwinbox HRMS MCP服务器

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

演示

特性

核心工具

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

时间管理工具

  • 考勤管理
    • 获得每月出勤率
    • 获得每日出勤率
    • 获取考勤表
    • 出勤率创纪录
    • 记录回溯出勤情况
  • 休假管理
    • 批准休假
    • 获取休假操作历史记录
    • 获取假期列表
    • 获取假期余额
    • 进口树叶

安装

  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许可证获得许可-有关详细信息,请参阅许可证文件。