hr

This MCP server exposes HR-related tools to Claude via the Model Context Protocol. The server provides four primary capabilities: get_employee_info for retrieving detailed employee data, search_employees for flexible querying across personnel attributes, request_global_leave to submit and manage multi-country leave requests, and translate_text to perform HR-aware translations with automatic language detection. Each tool accepts structured inputs (e.g., employee_id, query objects, date ranges, and optional metadata) and returns structured results suitable for downstream HR workflows. To integrate with Claude Desktop, connect Local Tool (via stdio) and point Claude to the server’s start script output, enabling Claude to invoke these tools through the MCP SDK.

Prerequisites:

• Node.js (LTS version) and npm installed on your machine
• Git installed

Installation steps:

1. Clone the repository: git clone https://github.com/yourusername/hr-mcp-server.git
2. Open the project directory: cd hr-mcp-server
3. Install dependencies: npm install
4. Build the project (if using a build step): npm run build
5. Start the server: npm start
6. Optional: run in development mode (if supported): npx ts-node-esm src/index.ts

Notes:

• The server is TypeScript-based and uses MCP SDKs for JavaScript/TypeScript. Ensure your environment supports TS compilation if you don’t pre-build.

Environment considerations:

• If sensitive HR data is used, ensure proper access controls and secure transport when integrating with Claude.
• Check that your build step outputs to dist/index.js (or adjust the mcp_config path accordingly).
• You can customize environment variables in the mcp_config under env (e.g., NODE_ENV, LOG_LEVEL).
• Typical troubleshooting includes verifying that the server process starts correctly, listening on the expected port/stdio path for Claude, and confirming that the MCP tools validate inputs with Zod schemas as described in the repo.