Skip to main content
Glama

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: Local File Management 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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables git repository operations through REST endpoints, providing access to repository status, diffs, and commits. Enforces security through configurable root directory allowlists for safe git operations.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables file system operations such as listing, reading, and creating files within a scoped local project directory. It provides a secure way to manage local files through standardized MCP tools built with FastMCP.
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    Exposes a secure, path-confined bridge to a local workspace and git remotes, enabling MCP clients to search, read, write, reset files, and perform git operations.
    -
  • F
    license
    A
    quality
    C
    maintenance
    Enables localized file system operations such as listing, reading, editing, creating, deleting, and searching files, scoped to the directory where the server is invoked.
    6
    -