Darwinbox HRMS MCP Server

Darwinbox HRMS MCP サーバー

Darwinbox HRMS API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、標準化されたインターフェースを通じて、従業員データ、勤怠、休暇管理のためのツールを提供します。

デモ

機能

基本ツール

• 従業員管理
  • 従業員の詳細を取得（単一、複数、または全従業員）
  • 従業員情報を更新
  • 新しい従業員を追加
  • 従業員を無効化
  • 個人文書をダウンロード
  • 従業員の履歴を取得
  • 役職マスターデータを取得
  • フォームデータを取得
  • 退職の詳細を取得
  • プロフィール添付ファイルをアップロード

勤怠管理ツール

• 勤怠管理
  • 月次勤怠を取得
  • 日次勤怠を取得
  • 勤怠名簿を取得
  • 勤怠打刻を記録
  • 過去の日付の勤怠を記録
• 休暇管理
  • 休暇を承認
  • 休暇の処理履歴を取得
  • 祝日一覧を取得
  • 休暇残数を取得
  • 休暇をインポート

インストール

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

MCP クライアントの設定

Claude Desktop クライアント

{
  "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 の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。