출석 관리 MCP 서버

이는 근태 정보 조회 및 양식 애플리케이션을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 직원 근태, 휴가 신청, 초과 근무 신청 및 일정 관리를 위한 도구와 리소스를 제공합니다.

특징

• 직원 정보 관리

• 출석 기록 추적

• 휴가 신청 관리

• 초과근무 요청 관리

• 일정 관리

• 통계 및 보고서

필수 조건

• Python 3.10 이상

• Neon PostgreSQL 데이터베이스

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. 가상 환경을 설정하고 필요한 종속성을 설치합니다.

   ./setup_venv.sh

3. 다음 내용이 포함된 .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

서버 실행

래퍼 스크립트를 사용하여 서버를 실행할 수 있습니다.

또는 가상 환경을 활성화하고 MCP CLI를 사용하세요.

Claude Desktop과 함께 사용

Claude Desktop과 함께 이 서버를 사용하려면:

1. claude.ai/download 에서 Claude Desktop을 설치하세요

2. Claude Desktop을 구성하려면 설치 스크립트를 실행하세요.

   python install_claude_desktop.py

3. Claude Desktop을 다시 시작하세요

문제 해결

"mcp라는 이름의 모듈이 없습니다" 오류가 발생하는 경우:

1. Claude Desktop이 사용하는 Python 환경에 MCP 패키지가 설치되어 있는지 확인하세요.

   ./install_dependencies.sh

2. 자세한 내용은 Claude Desktop 로그를 확인하세요.

   • macOS의 경우: ~/Library/Logs/Claude/mcp*.log

   • Windows의 경우: %APPDATA%\Claude\Logs\mcp*.log

3. 문제가 지속되면 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 : 출석 확인 프롬프트를 생성합니다.

특허

MIT