hr-mcp-server

The HR MCP Server is designed to provide structured access to employee data and HR operations through the Model Context Protocol. It allows Claude to perform tasks such as looking up detailed employee information, searching for employees by various criteria, managing global leave requests, and translating text with HR/HCM context awareness. The server is built using TypeScript and Node.js, with a focus on clean, maintainable code. It utilizes the MCP SDK for JavaScript/TypeScript and Zod for schema validation. The server's architecture is tool-based, with each tool having a clear responsibility, and it includes centralized logging, comprehensive error handling, and detailed documentation.

Features

• Look up detailed employee information
• Search for employees by various criteria
• Submit and manage global leave requests
• Translate text with HR/HCM context awareness

MCP Tools

• {'get_employee_info': 'Retrieves detailed information about a specific employee by ID, including personal details, employment information, skills, benefits, and more.'}
• {'search_employees': 'Search for employees by various criteria with flexible matching options. Supports searching by name, department, skills, location, and many other fields.'}
• {'request_global_leave': 'Submit global leave requests for employees traveling to multiple countries, with approval chains and compliance reminders.'}
• {'translate_text': 'Translates text from any language to a specified target language with automatic source language detection and special focus on HR/HCM terminology.'}

Usage with Different Platforms

npm

bash
# 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

start_server

bash
npm start

development_mode

bash
npx ts-node-esm src/index.ts