출석 관리 MCP 서버

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

특징

직원 정보 관리
출석 기록 추적
휴가 신청 관리
초과근무 요청 관리
일정 관리
통계 및 보고서

필수 조건

Python 3.10 이상
Neon PostgreSQL 데이터베이스

설치

이 저장소를 복제하세요:지엑스피1
가상 환경을 설정하고 필요한 종속성을 설치합니다.
./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 Desktop을 다시 시작하세요

문제 해결

"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 : 출석 확인 프롬프트를 생성합니다.

특허

MIT

Attendance Management MCP Server