Leave Manager MCP Server

Este proyecto es un servidor MCP en Python para gestionar empleados, saldos de permisos y solicitudes de permisos con SQLite.

1. Crear el proyecto

Abra PowerShell y cree un directorio de proyecto:

mkdir D:\Coding\mcpserver\LeaveManager
cd D:\Coding\mcpserver\LeaveManager

Cree un proyecto Python con uv dentro de leave_manager_server:

uv init leave_manager_server
cd leave_manager_server
uv add "mcp[cli]>=2.1.1"

El proyecto requiere Python 3.14 o posterior. uv crea pyproject.toml, uv.lock y el entorno virtual utilizado para ejecutar el servidor.

Related MCP server: leave_manager

2. Implementar el servidor

Cree server.py y añada las siguientes partes:

1. Importe MCPServer de mcp.server.mcpserver.

2. Cree el servidor con MCPServer("Leave Manager").

3. Defina los modelos de datos Employee y LeaveRequest.

4. Cree una base de datos SQLite junto a server.py utilizando una ruta absoluta.

5. Iniciale las tablas employees y leave_requests e inserte datos de ejemplo al inicio.

6. Añada recursos para los directorios de empleados y las solicitudes de permisos.

7. Añada herramientas para enviar y aproar permisos, consultar saldos, listar aproaciones pendientes, obtener estadísticas de la base de datos y añadir empleados.

8. Inicie el servidor desde el bloque __main__:

if __name__ == "__main__":
		init_database()
		mcp.run()

El proyecto utiliza MCP 2.x. La importación antigua de MCP 1.x no funciona con esta dependencia:

from mcp.server.fastmcp import FastMCP

La forma correcta de MCP 2.x es:

from mcp.server.mcpserver import MCPServer

mcp = MCPServer("Leave Manager")

3. Ejecutar el servidor directamente

Desde el directorio del proyecto:

cd D:\Coding\mcpserver\LeaveManager\leave_manager_server
uv run server.py

El servidor utiliza la entrada/salida estándar para la comunicación MCP, por lo que permanece en ejecución mientras haya un cliente MCP conectado. Pulse Ctrl+C para detenerlo.

Valide que el módulo se importa correctamente sin iniciar el servidor de larga duración:

uv run python -c "import server; print('Server import valid')"

4. Proar con MCP Inspector

El comando de desarrolo admitido es:

cd D:\Coding\mcpserver\LeaveManager\leave_manager_server
uv run mcp dev server.py

El MCP Inspector utiliza Node.js. Instale Node.js 22.19.0 o posterior antes de usar el Inspector más reciente. Compruebe las versiones con:

node --version
npm --version

No ejecute npm i en este directorio de proyecto Python porque no tiene package.json. Si Inspector informa de que falta un enlace nativo, borre la caché temporal de npx y vuelva a intentalo:

Remove-Item "$env:LOCALAPPDATA\npm-cache\_npx" -Recurse -Force
uv run mcp dev server.py

5. Conectar Claude Desktop

Claude Desktop lee su configración desde:

%APPDATA%\Claude\claude_desktop_config.json

Añada esta entrada de servidor. Sustituya la ruta si el proyecto está almacenado en otro lugar:

{
	"mcpServers": {
		"leave-manager": {
			"command": "uv",
			"args": [
				"run",
				"--directory",
				"D:\\Coding\\mcpserver\\LeaveManager\\leave_manager_server",
				"server.py"
			]
		}
	}
}

Reinicie Claude Desktop después de guardar la configración. El servidor crea leave_manager.db junto a server.py en su primer inicio.

Funciones MCP disponibles

Recursos:

• employees://all

• employee://{employee_id}

• leave-requests://all

• leave-requests://employee/{employee_id}

• leave-requests://status/{status}

Herramientas:

• submit_leave_request

• approve_leave_request

• check_leave_balance

• get_pending_approvals

• get_database_stats

• add_employee

• This will add my Config file automatic uv run mcp instll server.py --name "leave_manager"