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까지 연차로 추가"

• "E001의 휴가 기록 표시"

• "2026-08-20부터 2026-08-22까지 E001의 휴가 삭제"

로깅

서버는 다음 위치에 로그를 기록합니다:

• stderr: 즉시 출력용

• leave_management_mcp.log: 프로젝트 루트에 보관되는 문제 해결용 로그

이를 통해 Claude Desktop이 서버를 시작할 때 MCP 서버가 올바르게 시작되는지 확인할 수 있습니다.

검증

테스트 스위트를 실행하세요:

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

검증된 결과:

2 passed in 2.85s

프로젝트는 현재 회귀 테스트를 통과하며 서버 시작 경로가 검증되었습니다.