MCP-CLEAN

MCP-CLEAN ist eine lokale Steuerzentrale für freigegebene Projektordner auf diesem Rechner.

Architektur von MCP-CLEAN

• server.mjs - MCP-Server und Tool-Implementierungen

• config/allowed-roots.json - erlaubte Projekt-Stammverzeichnisse

• backups/ - Projektarchive und Datei-Backups

• logs/ - Betriebs-Logs

• logs/actions.log - Audit-Trail für Aktionen

• temp/ - temporäre Laufzeitdateien

• exchange/ - Austausch-Metadaten und Projektnotizen

• smoke-test.mjs - lokaler Smoke-Test

Related MCP server: Node Dev MCP Server

Alle verfügbaren Tools

• 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

Arbeiten mit Projekten

• Alle Vorgänge sind auf die Pfade aus config/allowed-roots.json beschränkt.

• system_status und git_status_all arbeiten nur für freigegebene Projekte.

• project_scan führt eine tiefgehende Strukturprüfung durch, ohne Dateien zu verändern.

• safe_change bereitet das Projekt über ein Backup und einen Checkpoint vor.

Backup

• Alle Archive und Datei-Backups werden ausschließlich unter F:\MCP-CLEAN\backups gespeichert.

• Die Namen der Archive enthalten einen Zeitstempel.

• Backup-Ergebnisse enthalten den Pfad, die Größe, Projektinformationen und die Liste der Archive.

Git-Checkpoint

• git_checkpoint führt stage, commit und push nach origin main aus.

• dryRun wird für eine sichere Prüfung ohne Änderungen unterstützt.

Rollback

• restore_project zeigt verfügbare Checkpoint-Commits an, sofern kein Commit angegeben ist.

• Vor dem Rollback wird ein Backup erstellt.

• Anschließend wird git reset --hard auf den ausgewählten Commit ausgeführt.

Logs

• logs/mcp-clean.log - Betriebs-Log.

• logs/actions.log - Aktionsprotokoll mit Datum, Tool, Projekt, Aktion und Ergebnis.

Arbeitsablauf

1. Gesundheit über health_check prüfen.

2. System über system_status anzeigen.

3. Projekt über project_scan analysieren.

4. Änderung über safe_change vorbereiten.

5. Bei Bedarf einen Checkpoint über git_checkpoint erstellen.

6. Bei Bedarf das Projekt über restore_project zurücksetzen.