Leave Management MCP Server

このプロジェクトは、UVとPythonで構築された従業員休暇管理システム用のシンプルなMCPサーバーを提供します。

機能

• 従業員を追加する

• 全従業員を一覧表示する

• 従業員の休暇エントリを追加する

• 従業員の休暇エントリを一覧表示する

• 休暇エントリを削除する

• トラブルシューティング用の起動ログとツールログ

Related MCP server: leave-manager-mcp-server

プロジェクト構造

• src/leave_management_mcp/server.py – MCPツール定義とインメモリの休暇データストア

• src/leave_management_mcp/__init__.py – パッケージのエクスポートとエントリポイント

• tests/test_leave_management.py – コア動作のリグレッションテスト

• leave_management_mcp.log – サーバーが生成するランタイムログファイル

ローカルでの実行

プロジェクトルートから:

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run leave-management-mcp

サーバーはstdioトランスポートを使用します。これはClaude Desktopで推奨されるトランスポートです。

Claude Desktopの設定

このファイルを作成または編集してください:

%APPDATA%\Claude\claude_desktop_config.json

次の正確な設定を使用してください:

{
  "mcpServers": {
    "leave-management": {
      "command": "C:\\Users\\VIJAY\\AppData\\Local\\Programs\\Python\\Python314\\Scripts\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\VIJAY\\Codebase\\mcp\\leave-management",
        "run",
        "leave-management-mcp"
      ]
    }
  }
}

重要:

• 以前のパス C:\Users\VIJAY\.local\bin\uv.exe はこのマシンでは無効でした。

• 実際にインストールされているUVのパスは、Python Scriptsフォルダの下にあります。

• ファイルを保存した後、Claude Desktopを再起動してください。

Claudeでのプロンプト例

• "社員E001、Alice Johnsonを追加"

• "全従業員を一覧表示"

• "E001の休暇を2026-08-20から2026-08-22までannualとして追加"

• "E001の休暇記録を表示"

• "E001の休暇を2026-08-20から2026-08-22まで削除"

ロギング

サーバーはログを以下に書き込みます:

• 即時出力用のstderr

• 永続的なトラブルシューティングのためのプロジェクトルート内のleave_management_mcp.log

これにより、Claude DesktopがMCPサーバーを起動したときに、MCPサーバーが正しく起動しているかどうかを確認できます。

検証

テストスイートを実行する:

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run pytest -q

検証結果:

2 passed in 2.85s

プロジェクトは現在のリグレッションテストに合格しており、サーバーの起動パスも検証されています。