projectlibre-mcp

MCP server para leer, analizar, crear y editar proyectos de ProjectLibre desde Claude, vía la librería MPXJ.

Cómo funciona

• Lee .pod (nativo de ProjectLibre) y .xml (MS Project / MSPDI) directamente.
• Escribe .xml (MSPDI). Para ver los cambios en ProjectLibre: File → Open el .xml generado (y, si quieres, Save As → .pod).
• No se puede escribir .pod directamente (formato propietario); por eso la escritura produce .xml.

Requisitos

• Java (JDK 21 recomendado; JAVA_HOME configurado).
• uv.

Instalación

uv sync

Registrar en Claude Code

claude mcp add -s user projectlibre -- uv run --directory "C:\Users\osyanne\Documents\Claude\Projects\projectlibre-mcp" projectlibre-mcp

Herramientas

Lectura / análisis (aceptan .pod o .xml):

• summarize_project(file) — resumen: nombre, fechas, # tareas/recursos, hitos.
• list_tasks(file, only_critical=False) — tareas con id, nombre, fechas, duración, %, predecesoras, recursos.
• get_task(file, task_id) — detalle de una tarea.
• list_resources(file) — recursos y sus asignaciones (tarea, unidades, trabajo).
• critical_path(file) — ruta crítica y holgura por tarea.

Creación / edición (escriben .xml MSPDI para importar):

• create_project(name, start_date, tasks, out) — proyecto desde cero. tasks = lista de {name, duration_days, predecessors?, resource?, percent_complete?, is_milestone?}. predecessors admite índices 1-based o nombres.
• add_task(file, name, duration_days, predecessors?, resource?, out?)
• update_task(file, task_id, fields, out?) — fields: name, duration_days, percent_complete, is_milestone, start.
• remove_task(file, task_id, out?)
• set_dependency(file, predecessor_id, successor_id, type="FS", lag_days=0, out?) — type ∈ {FS, SS, FF, SF}.
• assign_resource(file, task_id, resource_name, units=100, out?)

En las herramientas de edición, out es opcional si la entrada ya es .xml (se sobrescribe); si la entrada es .pod, out (.xml) es obligatorio. Las fechas usan formato YYYY-MM-DD; las duraciones, días laborables.

Flujo típico

1. Exporta tu proyecto desde ProjectLibre o crea uno con create_project.
2. Pídele a Claude que lo lea/analice/edite — los cambios se guardan en un .xml.
3. File → Open ese .xml en ProjectLibre para ver/persistir el resultado.

Limitaciones (v1)

• La escritura genera .xml (requiere abrirlo en ProjectLibre para persistir como .pod).
• critical_path lee valores de holgura/crítica ya calendarizados (archivos reales de ProjectLibre).
• Detección automática de sobreasignación de recursos: trabajo futuro.

Desarrollo

uv run pytest -q     # suite completa

Stack: Python 3.12 · mcp (FastMCP) · mpxj (JPype sobre JDK 21) · pytest. Arquitectura en capas: jvm → io → model → reader/writer → server.