MCP-CLEAN

MCP-CLEAN — это локальный центр управления для разрешенных папок проектов на этой машине.

Архитектура MCP-CLEAN

• server.mjs - реализация MCP-сервера и инструментов

• config/allowed-roots.json - разрешенные корни проектов

• backups/ - архивы проектов и резервные копии файлов

• logs/ - операционные журналы

• logs/actions.log - журнал аудита действий

• temp/ - временные файлы выполнения

• exchange/ - exchange-метаданные и заметки о проектах

• smoke-test.mjs - локальный смоук-тест

Related MCP server: Node Dev MCP Server

Все доступные инструменты

• 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

Работа с проектами

• Все операции ограничены путями из config/allowed-roots.json.

• system_status и git_status_all работают только по разрешенным проектам.

• project_scan выполняет глубокую проверку структуры без изменения файлов.

• safe_change подготавливает проект через backup и checkpoint.

Резервное копирование

• Все архивы и file-backups сохраняются только в F:\MCP-CLEAN\backups.

• Имена архивов содержат timestamp.

• Результаты backup включают путь, размер, информацию о проекте и список архивов.

Контрольная точка Git

• git_checkpoint делает stage, commit и push в origin/main.

• Поддерживается dry_run для безопасной проверки без изменений.

Откат

• restore_project показывает доступные checkpoint commit'ы, если commit не указан.

• Перед откатом создается backup.

• Затем выполняется git reset --hard на выбранный commit.

Логи

• logs/mcp-clean.log - операционные записи.

• logs/actions.log - журнал действий с датой, инструментом, проектом, действием и результатом.

Схема работы

1. Проверить здоровье через health_check.

2. Посмотреть систему через system_status.

3. Проанализировать проект через project_scan.

4. Подготовить изменение через safe_change.

5. При необходимости создать checkpoint через git_checkpoint.

6. При необходимости откатить проект через restore_project.