Attendance Management MCP Server

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)