HR MCP 서버

Claude Desktop과 함께 사용하도록 구축된 HR 운영을 위한 MCP(Model Context Protocol) 서버입니다.

https://github.com/user-attachments/assets/4cb89115-daf2-4647-81d2-aadd9e0dd29e

개요

이 서버는 Claude에게 직원 데이터와 HR 운영에 대한 체계적인 액세스를 제공하기 위해 모델 컨텍스트 프로토콜을 구현합니다.

HR MCP 서버를 통해 Claude는 다음을 수행할 수 있습니다.

• 자세한 직원 정보를 찾아보세요
• 다양한 기준으로 직원 검색
• 글로벌 휴가 요청 제출 및 관리
• HR/HCM 컨텍스트 인식을 통한 텍스트 번역

자세한 아키텍처 개요는 ARCHITECTURE.md를 참조하세요.

도구

서버는 Claude에게 다음과 같은 도구를 제공합니다.

1. get_employee_info

개인 정보, 고용 정보, 기술, 혜택 등을 포함하여 특정 직원의 ID에 대한 자세한 정보를 검색합니다.

지엑스피1

2. search_employees

유연한 매칭 옵션을 통해 다양한 기준으로 직원을 검색하세요. 이름, 부서, 기술, 위치 등 다양한 분야로 검색을 지원합니다.

3. 글로벌 request_global_leave

여러 국가로 출장하는 직원에게 승인 절차와 규정 준수 알림을 제공하여 글로벌 휴가를 신청할 수 있습니다.

4. 번역 프롬프트: translate_text

자동 소스 언어 감지 기능과 HR/HCM 용어에 중점을 두고 모든 언어의 텍스트를 지정된 대상 언어로 번역합니다.

번역 시스템은 인적 자본 관리 맥락에서 특별한 의미를 갖는 "복리후생", "기간", "수표", "직위" 등과 같은 용어의 기술적 의미를 보존하면서 맥락적 인식을 바탕으로 HR 관련 용어를 처리합니다.

설치

용법

1. 서버를 시작합니다:

2. 도구 유형으로 "로컬 도구(stdio를 통해)"를 선택하고 서버의 시작 스크립트 경로를 사용하여 Claude Desktop을 서버에 연결합니다.
3. Claude의 인터페이스를 통해 직원 데이터와 HR 도구에 접근하세요.

개발

• 소스 코드는 /src 디렉토리에 있습니다.
• 직원 데이터는 /src/data/employees.ts 에 저장됩니다.
• 서버는 엄격한 타이핑을 사용하는 TypeScript를 사용합니다.

개발 모드에서 실행하려면:

기술 스택

• 타입스크립트
• 노드.js
• @modelcontextprotocol/sdk - JavaScript/TypeScript용 MCP SDK
• Zod - TypeScript 우선 스키마 검증

코드 구조

서버는 깔끔하고 유지 관리하기 쉬운 코드에 중점을 두고 구성됩니다.

• 중앙 집중식 로깅 - 일관된 JSON-RPC 형식 로깅
• 도구 기반 아키텍처 - 각 도구에는 명확한 책임이 있습니다.
• 스키마 검증 - 모든 입력에 대해 Zod를 사용한 강력한 타이핑
• 오류 처리 - 명확한 오류 메시지를 통한 포괄적인 검증
• 문서 - 복잡한 논리를 설명하는 인라인 주석

특허

MIT

저작권 (c) 2024

본 소프트웨어 및 관련 문서 파일(이하 "소프트웨어")의 사본을 취득한 모든 사람에게 소프트웨어를 제한 없이 거래할 수 있는 권한을 무상으로 부여합니다. 여기에는 소프트웨어 사본을 사용, 복사, 수정, 병합, 게시, 배포, 하위 라이선스 및/또는 판매할 수 있는 권한이 포함되나 이에 국한되지 않으며, 소프트웨어가 제공된 사람에게도 이러한 권한을 부여합니다. 단, 다음 조건에 따라야 합니다.

위의 저작권 고지와 본 허가 고지는 소프트웨어의 모든 사본 또는 실질적인 부분에 포함되어야 합니다.

본 소프트웨어는 상품성, 특정 목적 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않는 명시적 또는 묵시적 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 저작자 또는 저작권자는 본 소프트웨어 또는 본 소프트웨어의 사용 또는 기타 거래와 관련하여 발생하는 계약, 불법 행위 또는 기타 소송을 포함한 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다.