Servidor MCP de gestión de permisos

Este proyecto proporciona un servidor MCP sencillo para un sistema de gestión de permisos de empleados construido con UV y Python.

Características

• Añadir empleados

• Listar todos los empleados

• Añadir registros de permisos para un empleado

• Listar registros de permisos de un empleado

• Eliminar registros de permisos

• Registro de inicio y de herramientas para la resolución de problemas

Related MCP server: leave-manager-mcp-server

Estructura del proyecto

• src/leave_management_mcp/server.py – definiciones de herramientas MCP y almacén de datos de permisos en memoria

• src/leave_management_mcp/__init__.py – exportaciones del paquete y punto de entrada

• tests/test_leave_management.py – pruebas de regresión para el comportamiento principal

• leave_management_mcp.log – archivo de registro de ejecución generado por el servidor

Ejecutar localmente

Desde la raíz del proyecto:

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run leave-management-mcp

El servidor utiliza el transporte stdio, que es el transporte recomendado para Claude Desktop.

Configuración de Claude Desktop

Cree o edite este archivo:

%APPDATA%\Claude\claude_desktop_config.json

Use esta configuración exacta:

{
  "mcpServers": {
    "leave-management": {
      "command": "C:\\Users\\VIJAY\\AppData\\Local\\Programs\\Python\\Python314\\Scripts\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\VIJAY\\Codebase\\mcp\\leave-management",
        "run",
        "leave-management-mcp"
      ]
    }
  }
}

Importante:

• La ruta anterior C:\Users\VIJAY\.local\bin\uv.exe no era válida en este equipo.

• La ruta real de instalación de UV está en la carpeta de Scripts de Python.

• Reinicie Claude Desktop después de guardar el archivo.

Ejemplos de indicaciones en Claude

• "Añada empleado E001, Alice Johnson"

• "Liste todos los empleados"

• "Añada permiso para E001 del 2026-08-20 al 2026-08-22 como permiso anual"

• "Muestre los registros de permiso de E001"

• "Elimine el permiso para E001 del 2026-08-20 al 2026-08-22"

Registro

El servidor escribe los registros en:

• stderr para la salida inmediata

• leave_management_mcp.log en la raíz del proyecto para la resolución de problemas persistente

Esto ayuda a confirmar si el servidor MCP se está iniciando correctamente cuando Claude Desktop lo lanza.

Validación

Ejecute la suite de pruebas:

cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run pytest -q

Resultado verificado:

2 passed in 2.85s

El proyecto supera las pruebas de regresión actuales y se ha verificado la ruta de inicio del servidor.