Servidor MCP de gestión de asistencia

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para consultas de información de asistencia y aplicaciones de formularios. Proporciona herramientas y recursos para gestionar la asistencia de los empleados, las solicitudes de permisos, las solicitudes de horas extra y los horarios.

Características

• Gestión de la información de los empleados

• Seguimiento de registros de asistencia

• Gestión de solicitudes de licencia

• Gestión de solicitudes de horas extras

• Gestión de horarios

• Estadísticas e informes

Prerrequisitos

• Python 3.10 o superior

• Base de datos Neon PostgreSQL

Instalación

1. Clonar este repositorio:

   git clone https://github.com/yourusername/attendance-mcp-server.git cd attendance-mcp-server

2. Configure un entorno virtual e instale las dependencias necesarias:

   ./setup_venv.sh

3. Configure la conexión a la base de datos creando un archivo .env con el siguiente contenido:

   DB_HOST=db.weathered-shadow-70756968.us-east-2.aws.neon.tech DB_NAME=shinedb DB_USER=shine_user DB_PASSWORD=Shine@123456#! DB_PORT=5432

Ejecución del servidor

Puede ejecutar el servidor utilizando el script wrapper:

O active el entorno virtual y utilice la CLI de MCP:

Uso con Claude Desktop

Para utilizar este servidor con Claude Desktop:

1. Instalar Claude Desktop desde claude.ai/download

2. Ejecute el script de instalación para configurar Claude Desktop:

   python install_claude_desktop.py

3. Reiniciar Claude Desktop

Solución de problemas

Si encuentra el error "No hay módulo llamado 'mcp'":

1. Asegúrese de que el paquete MCP esté instalado en el entorno de Python que utiliza Claude Desktop:

   ./install_dependencies.sh

2. Consulte los registros de Claude Desktop para obtener más información:

   • En macOS: ~/Library/Logs/Claude/mcp*.log

   • En Windows: %APPDATA%\Claude\Logs\mcp*.log

3. Si el problema persiste, intente ejecutar el servidor MCP manualmente para ver si hay algún error:

   ./run_attendance_mcp.sh

Herramientas disponibles

Información del empleado

• get_employee_info : Obtener información del empleado por ID o número de empleado

• list_employees : Lista de empleados con filtrado opcional

• list_departments : Lista todos los departamentos

Registros de asistencia

• get_attendance_records : Obtener registros de asistencia con filtrado opcional

• submit_attendance_record : Enviar un nuevo registro de asistencia o actualizar uno existente

Gestión de licencias

• get_leave_requests : Obtener solicitudes de permiso con filtrado opcional

• submit_leave_request : Enviar una nueva solicitud de permiso

• approve_leave_request : Aprobar o rechazar una solicitud de permiso

Gestión de horas extras

• get_overtime_requests : Obtener solicitudes de horas extra con filtrado opcional

• submit_overtime_request : Enviar una nueva solicitud de horas extra

• approve_overtime_request : Aprobar o rechazar una solicitud de horas extra

Gestión de horarios

• get_employee_schedule : Obtener el horario de los empleados con filtrado opcional

• list_shifts : Lista todos los turnos disponibles

• assign_schedule : Asignar un horario a un empleado

Estadísticas e informes

• get_monthly_attendance_stats : Obtener estadísticas mensuales de asistencia

• get_holidays : Obtener vacaciones con filtrado opcional

Recursos disponibles

• employee://{employee_id} : Obtener información del empleado como recurso

• department://{department_id} : Obtener información del departamento como recurso

• attendance://{employee_id}/{date} : Obtener información de asistencia para un empleado y fecha específicos

Indicaciones disponibles

• request_leave : Crea un mensaje de solicitud de permiso

• request_overtime : Crea un aviso de solicitud de horas extra

• check_attendance : Crea un aviso de verificación de asistencia

Licencia

Instituto Tecnológico de Massachusetts (MIT)