Gestor de proyectos MCP (Terminal + Web + Escritorio)

Este proyecto admite tres interfaces sobre un mismo backend:

• Suite de terminal

• API REST + Interfaz React

• Servidor MCP stdio

• Lanzador de escritorio opcional en Python (abre el navegador en la aplicación local)

Inicio rápido

1. Iniciar infraestructura: docker compose up -d

2. Aplicar esquema: psql postgresql://postgres:postgres@localhost:5432/mcp_pm -f backend/sql/schema.sql

3. Compilar frontend para http://localhost:4000/: npm run build

4. Iniciar servidor API: npm run start

Si falta la compilación del frontend, / devuelve un mensaje claro con los siguientes pasos.

Modos de ejecución independientes

• Suite de terminal: npm run terminal

• Servidor MCP stdio: npm run mcp

• Lanzador de escritorio (modo adjunto): npm run desktop

• Lanzador de escritorio (inicio automático del backend): npm run desktop:start

Equivalentes del espacio de trabajo del backend:

• npm --workspace backend run terminal

• npm --workspace backend run mcp

• npm --workspace backend run desktop

• npm --workspace backend run desktop:start

Adiciones a la API

• GET /api/projects/:id/plans (filtros + paginación)

• GET /api/projects/:id/plans/compare?againstVersion=N

• POST /api/plans/:planId/promote-baseline

• POST /api/analysis/summarize-codebase (resumen de toda la carpeta, descripciones por archivo, pipeline de Mermaid)

• La acción de feedback incluye needs_review

• Opciones de generación de estructura: profile, dryRun, overwriteStrategy

Seguridad del sistema de archivos

Los endpoints del sistema de archivos están restringidos a FS_BASE_PATH (predeterminado: el directorio de trabajo del backend).