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를 참조하세요.
Related MCP server: MCP Tools
도구
서버는 Claude에게 다음과 같은 도구를 제공합니다.
1. get_employee_info
개인 정보, 고용 정보, 기술, 혜택 등을 포함하여 특정 직원의 ID에 대한 자세한 정보를 검색합니다.
지엑스피1
2. search_employees
유연한 매칭 옵션을 통해 다양한 기준으로 직원을 검색하세요. 이름, 부서, 기술, 위치 등 다양한 분야로 검색을 지원합니다.
// Basic search:
search_employees({
query: { department: "Engineering" }
})
// Advanced search:
search_employees({
query: {
location: "Seattle",
performance_rating: 5
},
options: {
sort_by: "hireDate",
output_format: "detailed"
}
})
// Search with sensitive information:
search_employees({
query: { salary_min: 100000 },
options: { include_sensitive: true }
})3. 글로벌 request_global_leave
여러 국가로 출장하는 직원에게 승인 절차와 규정 준수 알림을 제공하여 글로벌 휴가를 신청할 수 있습니다.
// Basic request:
request_global_leave({
employee_id: "E002",
start_date: "2025-05-01",
end_date: "2025-05-15",
reason: "Family vacation",
countries: ["USA", "UK"]
})
// With custom contact info:
request_global_leave({
employee_id: "E002",
start_date: "2025-05-01",
end_date: "2025-05-15",
reason: "Family vacation",
countries: ["USA", "UK"],
contact_info: {
email: "bob.vacation@example.com",
phone: "+1-555-123-4567"
}
})4. 번역 프롬프트: translate_text
자동 소스 언어 감지 기능과 HR/HCM 용어에 중점을 두고 모든 언어의 텍스트를 지정된 대상 언어로 번역합니다.
// Basic translation:
translate_text({
text: "Les employés doivent soumettre leurs feuilles de temps avant la fin de la période.",
target_language: "English"
})번역 시스템은 인적 자본 관리 맥락에서 특별한 의미를 갖는 "복리후생", "기간", "수표", "직위" 등과 같은 용어의 기술적 의미를 보존하면서 맥락적 인식을 바탕으로 HR 관련 용어를 처리합니다.
설치
# Clone the repository
git clone https://github.com/yourusername/hr-mcp-server.git
cd hr-mcp-server
# Install dependencies
npm install
# Build the project
npm run build용법
서버를 시작합니다:
npm start도구 유형으로 "로컬 도구(stdio를 통해)"를 선택하고 서버의 시작 스크립트 경로를 사용하여 Claude Desktop을 서버에 연결합니다.
Claude의 인터페이스를 통해 직원 데이터와 HR 도구에 접근하세요.
개발
소스 코드는
/src디렉토리에 있습니다.직원 데이터는
/src/data/employees.ts에 저장됩니다.서버는 엄격한 타이핑을 사용하는 TypeScript를 사용합니다.
개발 모드에서 실행하려면:
npx ts-node-esm src/index.ts기술 스택
타입스크립트
노드.js
@modelcontextprotocol/sdk - JavaScript/TypeScript용 MCP SDK
Zod - TypeScript 우선 스키마 검증
코드 구조
서버는 깔끔하고 유지 관리하기 쉬운 코드에 중점을 두고 구성됩니다.
중앙 집중식 로깅 - 일관된 JSON-RPC 형식 로깅
도구 기반 아키텍처 - 각 도구에는 명확한 책임이 있습니다.
스키마 검증 - 모든 입력에 대해 Zod를 사용한 강력한 타이핑
오류 처리 - 명확한 오류 메시지를 통한 포괄적인 검증
문서 - 복잡한 논리를 설명하는 인라인 주석
특허
MIT
저작권 (c) 2024
본 소프트웨어 및 관련 문서 파일(이하 "소프트웨어")의 사본을 취득한 모든 사람에게 소프트웨어를 제한 없이 거래할 수 있는 권한을 무상으로 부여합니다. 여기에는 소프트웨어 사본을 사용, 복사, 수정, 병합, 게시, 배포, 하위 라이선스 및/또는 판매할 수 있는 권한이 포함되나 이에 국한되지 않으며, 소프트웨어가 제공된 사람에게도 이러한 권한을 부여합니다. 단, 다음 조건에 따라야 합니다.
위의 저작권 고지와 본 허가 고지는 소프트웨어의 모든 사본 또는 실질적인 부분에 포함되어야 합니다.
본 소프트웨어는 상품성, 특정 목적 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않는 명시적 또는 묵시적 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 저작자 또는 저작권자는 본 소프트웨어 또는 본 소프트웨어의 사용 또는 기타 거래와 관련하여 발생하는 계약, 불법 행위 또는 기타 소송을 포함한 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다.