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.

Related MCP server: FS-MCP

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.