Servidor MCP de RR.HH.

Un servidor de Protocolo de Contexto de Modelo (MCP) para operaciones de RR.HH. creado para su uso con Claude Desktop.

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

Descripción general

Este servidor implementa el Protocolo de Contexto de Modelo para proporcionar a Claude acceso estructurado a los datos de los empleados y a las operaciones de RR.HH.

El servidor HR MCP permite a Claude:

Busque información detallada de los empleados
Búsqueda de empleados por diversos criterios
Enviar y gestionar solicitudes de licencia globales
Traducir texto con conocimiento del contexto de RR.HH./HCM

Para obtener una descripción arquitectónica detallada, consulte ARCHITECTURE.md .

Herramientas

El servidor proporciona las siguientes herramientas a Claude:

1. `get_employee_info`

Recupera información detallada sobre un empleado específico por identificación, incluidos detalles personales, información de empleo, habilidades, beneficios y más.

// Example usage:
get_employee_info({ employee_id: "E001" })

// With sensitive information:
get_employee_info({ employee_id: "E001", include_sensitive: true })

2. `search_employees`

Busque empleados por diversos criterios con opciones de coincidencia flexibles. Permite buscar por nombre, departamento, habilidades, ubicación y muchos otros campos.

// 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`

Envíe solicitudes de licencia globales para empleados que viajan a varios países, con cadenas de aprobación y recordatorios de cumplimiento.

// 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. Mensaje de traducción: `translate_text`

Traduce texto de cualquier idioma a un idioma de destino específico con detección automática del idioma de origen y un enfoque especial en la terminología de RR.HH./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" 
})

El sistema de traducción maneja la terminología específica de RR.HH. con conocimiento del contexto, preservando el significado técnico de términos como "beneficios", "período", "cheque", "puesto", etc., que tienen significados especiales en contextos de gestión de capital humano.

Instalación

# 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

Uso

Iniciar el servidor:

npm start

Conecte Claude Desktop al servidor seleccionando "Herramienta local (a través de stdio)" como tipo de herramienta y utilizando la ruta al script de inicio del servidor.
Acceda a los datos de los empleados y a las herramientas de RR.HH a través de la interfaz de Claude.

Desarrollo

El código fuente está en el directorio /src
Los datos de los empleados se almacenan en /src/data/employees.ts
El servidor utiliza TypeScript con tipificación estricta

Para ejecutar en modo de desarrollo:

npx ts-node-esm src/index.ts

Pila tecnológica

Mecanografiado
Node.js
@modelcontextprotocol/sdk - SDK de MCP para JavaScript/TypeScript
Zod - Validación de esquemas basada en TypeScript

Estructura del código

El servidor está organizado con el foco puesto en un código limpio y mantenible:

Registro centralizado : registro consistente con formato JSON-RPC
Arquitectura basada en herramientas : cada herramienta tiene una responsabilidad clara
Validación de esquemas : tipificación fuerte con Zod para todas las entradas
Manejo de errores : validación integral con mensajes de error claros
Documentación : Comentarios en línea que explican lógica compleja

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Por la presente se concede permiso, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para tratar el Software sin restricción, incluyendo, sin limitación, los derechos a usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y para permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones:

El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, ENTRE OTRAS, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN DETERMINADO Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑOS U OTRAS RESPONSABILIDADES, YA SEA EN ACCIÓN CONTRACTUAL, EXTRACONTRACTUAL O DE OTRO TIPO, QUE SURJA DE, SE DERIVE DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS RELACIONES CON EL MISMO.

HR MCP Server