Darwinbox MCP

🚀 Darwinbox HRMS MCP サーバー

このサーバーは、Darwinbox HRMS API とのインタラクションを行うためのモデルコンテキストプロトコル (MCP) サーバーです。社員データ管理、勤怠管理、休暇管理のための標準インターフェースツールを提供します。

🚀 クイックスタート

デモ

✨ 主な機能

コアツール

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

勤怠管理ツール

• 勤怠管理
  • 月次勤怠記録を取得
  • 日次勤怠記録を取得
  • 勤務表勤怠 roster を取得
  • 勤怠打刻を記録
  • 遡及的な勤怠を記録
• 休暇管理
  • 休暇申請を承認
  • 休暇操作履歴を取得
  • 休暇リストを取得
  • 休暇残高を取得
  • 休暇記録をインポート

📦 インストール

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

認証

サーバーは OAuth 2.0 を使用して認証を行います。以下を自動的に処理します：

1. 提供された資格情報を使用してトークンを取得
2. トークンの管理と更新
3. 適切なヘッダー情報を含む認証済み API リクエスト

エラー処理

サーバーは詳細なエラーメッセージを提供します。内容は以下の通りです：

• 設定が欠落または無効
• 認証に失敗
• 無効な API リクエスト
• API 応答エラー

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。