HR Assistant MCP Server

실용적인 로컬 HR 어시스턴트로, 직원 온보딩, 휴가 추적, 회의 조율, 업무 요청을 처리합니다. 데이터베이스나 유료 서비스 없이 모든 MCP 호환 클라이언트에 연결됩니다.

시스템 설계

MCP 서버는 HR 워크플로의 유일한 진입 점입니다. 직원, 가, 회의, 요청 기는 각각 독립된 모듈로 분리되어 있으며, 이메일 전송은 선택 사항으로 남아 있입. 빠른 데모 체험을 위해 데이터는 로컬 메모리에 저장됩니다.

Related MCP server: multi-mail-mcp

주요 기

• 단일 툴 호출로 직원을 온보딩합니다.

• 관리자와 직접 보고 관계를 포함하는 직원 디렉터리를 유지합니다.

• 잔여 휴가 일수를 확인하고, 휴가 날짜를 제출하며, 휴가 이력을 검토합니다.

• 오리엔테이션 또는 HR 회의를 예약, 조회, 취소합니다.

• 노트북, 헤드셋, 출입 배지 및 기타 업무 요청을 생성하고 업데이합니다.

• 자격 증명이 로컬에서 구성되면 SMTP를 통해 알림을 전송합니다.

• 즉시 테스트하고자 하는 몬터카를로 준비된 샘플 직원으로 시작 가능합니다.

시작하기

요구 사항: Python 3.10 이상입니다.

git clone https://github.com/sarthak-here/hr-assistant-mcp.git
cd hr-assistant-mcp
python -m pip install -e ".[test]"
python server.py

MCP 서버는 표준 입력/출력을 통해 확인 통신합니다. 이는 MCP 클라이언트가 요구하는 방식입니다. 직접 실행하면 대화상 채트 프롬프트는 산시하지 않습니다.

변경 사항이 있을 때마다 테스트 스위트를 실행하세요:

python -m pytest

MCP 클라이언트에 추가

클라이언트 구성에서 복제한 프로젝트의 절대 경로를 사용하세요.

{
  "mcpServers": {
    "hr-assistant": {
      "command": "python",
      "args": ["C:\\path\\to\\hr-assistant-mcp\\server.py"]
    }
  }
}

연결 후 다음 요청 중 하나를 사용해 보세요:

Show the current employee directory.
Onboard Priya Shah as a Product Analyst reporting to EMP-002.
Check the leave balance for EMP-003.
Create a monitor request for EMP-004.

주요 도구

onboard_employee는 직원 기록, 가 계정, 그리고 기본적인 노트북, 헤드셋, 출입 배지 요청을 한께 만듭니다. 오리엔테이션은 시간이 확정된 후 별도로 일정해야 합니다.

이메일 설정

이메일은 선택 사항입니다. set_notification을 사욕려면 .env.example을 .env로 복동하세요.

Copy-Item .env.example .env

.env 파일은 Git에서 무시됩니다. 이메일 구성을 하다 않도 다른 모든 HR 시능은 정상적으로 릉합니다.

프로젝트 파일

hr-assistant-mcp/
  assets/             Hand-drawn system-design image
  peopleops/          Domain models and HR workflow managers
  tests/              Automated checks
  server.py           MCP tools
  emails.py           Optional SMTP notifications
  .env.example        Safe configuration template
  pyproject.toml      Project dependencies and test settings