勤怠管理MCPサーバー

これは、勤怠情報のクエリとフォームアプリケーション用のモデルコンテキストプロトコル（MCP）サーバーです。従業員の勤怠、休暇申請、残業申請、スケジュール管理のためのツールとリソースを提供します。

特徴

従業員情報管理
出席記録の追跡
休暇申請管理
残業申請管理
スケジュール管理
統計とレポート

前提条件

Python 3.10以上
Neon PostgreSQLデータベース

インストール

このリポジトリをクローンします:
git clone https://github.com/yourusername/attendance-mcp-server.git cd attendance-mcp-server
仮想環境をセットアップし、必要な依存関係をインストールします。
./setup_venv.sh
次の内容の.envファイルを作成して、データベース接続を構成します。
DB_HOST=db.weathered-shadow-70756968.us-east-2.aws.neon.tech DB_NAME=shinedb DB_USER=shine_user DB_PASSWORD=Shine@123456#! DB_PORT=5432

サーバーの実行

ラッパースクリプトを使用してサーバーを実行できます。

./run_mcp.sh

または、仮想環境をアクティブにして、MCP CLI を使用します。

source .venv/bin/activate
mcp run attendance_mcp_server.py

Claude Desktopでの使用

このサーバーをClaude Desktopで使用するには:

claude.ai/downloadからClaude Desktopをインストールします。
インストールスクリプトを実行して、Claude Desktop を構成します。
python install_claude_desktop.py
Claudeデスクトップを再起動します

トラブルシューティング

「'mcp' という名前のモジュールがありません」というエラーが発生した場合:

Claude Desktop が使用している Python 環境に MCP パッケージがインストールされていることを確認します。
./install_dependencies.sh
詳細については、Claude Desktop のログを確認してください。
- macOSの場合: ~/Library/Logs/Claude/mcp*.log
- Windowsの場合: %APPDATA%\Claude\Logs\mcp*.log
問題が解決しない場合は、MCP サーバーを手動で実行して、エラーがないか確認してください。
./run_attendance_mcp.sh

利用可能なツール

従業員情報

get_employee_info : IDまたは従業員番号で従業員情報を取得する
list_employees : オプションのフィルタリングを使用して従業員を一覧表示する
list_departments : すべての部門を一覧表示する

出席記録

get_attendance_records : オプションのフィルタリングを使用して出席記録を取得します。
submit_attendance_record : 新しい出席記録を送信するか、既存の出席記録を更新します

休暇管理

get_leave_requests : オプションのフィルタリングを使用して休暇申請を取得する
submit_leave_request : 新しい休暇申請を送信する
approve_leave_request : 休暇申請を承認または拒否する

残業管理

get_overtime_requests : オプションのフィルタリングを使用して残業リクエストを取得する
submit_overtime_request : 新しい残業リクエストを送信する
残業リクエストapprove_overtime_requestまたは拒否する

スケジュール管理

get_employee_schedule : オプションのフィルタリングを使用して従業員のスケジュールを取得する
list_shifts : 利用可能なシフトをすべて一覧表示する
assign_schedule : 従業員にスケジュールを割り当てる

統計とレポート

get_monthly_attendance_stats : 月間出席統計を取得する
get_holidays : オプションのフィルタリングで休日を取得する

利用可能なリソース

employee://{employee_id} : 従業員情報をリソースとして取得する
department://{department_id} : 部門情報をリソースとして取得する
attendance://{employee_id}/{date} : 特定の従業員と日付の出勤情報を取得します。

利用可能なプロンプト

request_leave : 休暇申請プロンプトを作成する
request_overtime : 残業リクエストプロンプトを作成する
check_attendance : 出席確認プロンプトを作成する

ライセンス

マサチューセッツ工科大学

Attendance Management MCP Server