LeaveManager MCP Server

LeaveManager MCP Server

従業員の休暇申請、残日数、履歴を管理する Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、標準化された API エンドポイントを通じて、休暇管理業務をシンプルかつ効率的に処理できます。

Features

• 休暇残日数の管理：従業員の残りの休暇日数を確認します
• 休暇の申請：指定した日付の休暇を申請します
• 休暇履歴：従業員の休暇履歴全体を確認します
• 日付範囲のサポート：連続または不連続の複数の日付で休暇を申請します
• 残日数のリアルタイム更新：休暇申請後に残日数を自動更新します

Available Functions

1. 休暇残日数の取得

特定の従業員の残りの休暇日数を確認します。

{
  "function": "get_leave_balance",
  "parameters": {
    "employee_id": "string"
  }
}

応答：従業員の残りの休暇日数を返します。

2. 休暇の申請

指定した日付の休暇を申請します。

{
  "function": "apply_leave",
  "parameters": {
    "employee_id": "string",
    "leave_dates": ["2025-06-03", "2025-06-04"]
  }
}

応答：休暇申請を確認し、更新後の残日数を返します。

3. 休暇履歴の取得

従業員の休暇履歴全体を取得します。

{
  "function": "get_leave_history",
  "parameters": {
    "employee_id": "string"
  }
}

応答：すべての休暇申請とそのステータスを時系列順に返します。

Usage Examples

休暇残日数を確認する

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "get_leave_balance",
    "params": {
      "employee_id": "E001"
    }
  }'

1 日の休暇を申請する

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "apply_leave",
    "params": {
      "employee_id": "E001",
      "leave_dates": ["2025-06-03"]
    }
  }'

複数日の休暇を申請する

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "apply_leave",
    "params": {
      "employee_id": "E001",
      "leave_dates": ["2025-06-03", "2025-06-04", "2025-06-05"]
    }
  }'

日付形式

すべての日付は ISO 8601 形式で指定してください：YYYY-MM-DD

例：

• 2025-06-03（2025 年 6 月 3 日）
• 2025-12-25（2025 年 12 月 25 日）

エラー処理

このサーバーは、一般的な状況に対して詳細なエラー応答を返します。

• 無効な従業員 ID：従業員が存在しない場合にエラーを返します
• 休暇残日数の不足：残り日数が不足している場合、休暇申請を防止します
• 無効な日付形式：日付の形式が不正な場合にエラーを返します
• 過去の日付での申請：過去の日付の申請を防止します
• 休暇申請の重複：すでに承認済みの日付への申請を防止します

API 応答形式

成功応答

{
  "success": true,
  "data": {
    "message": "Leave applied for 1 day(s). Remaining balance: 17."
  }
}

エラー応答

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient leave balance. Required: 3, Available: 2"
  }
}

ライセンス

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

変更履歴

v1.0.0

• 初回リリース
• 基本的な休暇管理機能
• 従業員の残日数の追跡
• 休暇申請システム
• 休暇履歴の取得

---

注：これは、AI アシスタントおよび自動化ツールと連携するように設計された MCP（Model Context Protocol）サーバーです。