MCP-CLEAN

MCP-CLEAN es un centro de control local para las carpetas de proyectos aprobadas en esta máquina.

Arquitectura de MCP-CLEAN

• server.mjs - implementación del servidor MCP y de las herramientas

• config/allowed-roots.json - directorios raíz de proyectos permitidos

• backups/ - backups de proyectos y de archivos

• logs/ - logs operativos

• logs/actions.log - registro de auditoría de acciones

• temp/ - archivos temporales de ejecución

• exchange/ - metadatos de intercambio y notas de proyecto

• smoke-test.mjs - prueba de humo local

Related MCP server: Local File Management MCP Server

Todas las herramientas disponibles

• ping

• list_directory

• read_file

• write_file

• project_status

• backup_project

• health_check

• git_status_all

• git_checkpoint

• restore_project

• system_status

• project_scan

• safe_change

Trabajo con proyectos

• Todas las operaciones están restringidas a las rutas de config/allowed-roots.json.

• system_status y git_status_all solo operan sobre los proyectos permitidos.

• project_scan realiza una verificación exhaustiva de la estructura sin modificar archivos.

• safe_change prepara el proyecto mediante backup y checkpoint.

Backup

• Todos los backups de proyectos y de archivos se guardan únicamente en F:\MCP-CLEAN\backups.

• Los nombres de los backups incluyen un timestamp.

• Los resultados del backup incluyen la ruta, el tamaño, la información del proyecto y la lista de backups.

Git checkpoint

• git_checkpoint hace stage, commit y push a origin.

• Se admite dryRun para una comprobación segura sin cambios.

Rollback

• restore_project muestra los commits de checkpoint disponibles si no se ha especificado un commit.

• Antes del rollback se crea un backup.

• A continuación se ejecuta git reset --hard hasta el commit seleccionado.

Logs

• logs/mcp-clean.log — registros operativos.

• logs/actions.log — historial de acciones con fecha, herramienta, proyecto, acción y resultado.

Flujo de trabajo

1. Comprobar el estado mediante health_check.

2. Consultar el sistema mediante system_status.

3. Analizar el proyecto mediante project_scan.

4. Preparar el cambio mediante safe_change.

5. Si es necesario, crear un checkpoint mediante git_checkpoint.

6. Si es necesario, revertir el proyecto mediante restore_project.