HR Assistant MCP Server

Un asistente de RRHH local y práctico para la incorporación de empleados, el seguimiento de permisos, la coordinación de reuniones y las solicitudes laborales. Se conecta con cualquier cliente compatible con MCP y funciona sin base de datos ni servicios de pago.

Diseño del sistema

El servidor MCP es el punto de entrada único para los flujos de trabajo de RRHH. Las funciones de empleados, permisos, reuniones y solicitudes laborales son módulos separados, mientras que el envío de correos electrónicos permanece opcional. Los datos se almacenan localmente en memoria para una experiencia de demostración rápida.

Related MCP server: multi-mail-mcp

Aspectos destacados

• Incorpora empleados con una sola llamada a una herramienta.

• Mantén un directorio de empleados con las relaciones entre responsables y subordinados directos.

• Consulta saldos de permisos, envía las fechas de permiso y revisa el historial de permisos.

• Programa, lista y cancela reuniones de orientación o de RRHH.

• Crea y actualiza solicitudes de portátiles, auriculares, tarjetas de acceso y otras solicitudes laborales.

• Envía notificaciones por SMTP cuando las credenciales estén configuradas localmente.

• Empieza con una muestra determinista de empleados de ejemplo para probar de inmediato.

Primeros pasos

Requisitos: Python 3.10 o superior.

git clone https://github.com/sarthak-here/hr-assistant-mcp.git
cd hr-assistant-mcp
python -m pip install -e ".[test]"
python server.py

El servidor se comunica mediante la entrada y salida estándar, que es lo que esperan los clientes MCP. No mostrará un prompt de chat interactivo cuando se inicie directamente.

Ejecuta la suite de pruebas cada vez que hagas cambios:

python -m pytest

Añadir a un cliente MCP

Usa una ruta absoluta al proyecto clonado en la configuración de tu cliente.

{
  "mcpServers": {
    "hr-assistant": {
      "command": "python",
      "args": ["C:\\path\\to\\hr-assistant-mcp\\server.py"]
    }
  }
}

Después de conectarte, prueba una de estas solicitudes:

Show the current employee directory.
Onboard Priya Shah as a Product Analyst reporting to EMP-002.
Check the leave balance for EMP-003.
Create a monitor request for EMP-004.

Herramientas principales

onboard_employee crea el registro del empleado, la cuenta de permisos y las solicitudes estándar de portátil, auriculares y tarjeta de acceso en una sola operación. Programa la orientación por separado una vez que se confirme la fecha.

Configuración de email

El email es opcional. Copia .env.example a .env y rellena los valores de SMTP si quieres usar send_notification.

Copy-Item .env.example .env

El archivo .env está ignorado por Git. Todas las demás funciones de RRHH funcionan sin configurar el correo electrónico.

Archivos del proyecto

hr-assistant-mcp/
  assets/             Hand-drawn system-design image
  peopleops/          Domain models and HR workflow managers
  tests/              Automated checks
  server.py           MCP tools
  emails.py           Optional SMTP notifications
  .env.example        Safe configuration template
  pyproject.toml      Project dependencies and test settings