Files
MikrotikManager/docs/mcp-dependency-audit-20261101.md
T

8.8 KiB

Почему MCP породил столько доработок

Сверка на 1 ноября 2026 относительно HEAD 5efd0339fb. Полный согласованный объём сохраняется. Этот аудит меняет объяснение зависимостей и порядок работы, а не объявляет непроверенные функции готовыми.

Пакеты

Добавлены четыре прямые рабочие зависимости backend: официальные MCP server, client, Node и Fastify модули. Они используются транспортом и stdio-мостом. Новых прямых зависимостей frontend нет. Добавлена одна прямая dev-зависимость embedded-postgres для изолированных SQL-тестов.

Точный состав 15 новых записей lock-файла: пять рабочих (четыре прямых SDK + общий core) и десять тестовых (embedded-postgres, восемь платформенных native-пакетов и async-exit-hook). Наличие восьми платформенных записей не означает запуск восьми серверов. Dockerfile выполняет npm prune --omit=dev перед копированием зависимостей в рабочий образ. Сам собранный образ этим аудитом не исследован; работа всей установки в пределах 2 ГБ не подтверждена.

Откуда взялся основной объём

В одном плане оказались протокольный адаптер, полное покрытие бизнес-сервисов, система управляемых изменений, новый автономный контроллер сети, защищённый жизненный цикл восстановления БД и полная эксплуатационная приёмка. Кроме того, я учитывал крупные родительские требования одним счётчиком, пока внутри них добавлялись и проверялись компоненты. Поэтому прежнее повторение «32 пакета» скрывало выполненную работу и плохо описывало остаток.

Функция Необходимые зависимости Что не является общей зависимостью этой функции
MCP transport/discovery/stdio SDK, авторизация, валидные схемы, ограничения протокола Третий CHR, полнота интервала логов RouterOS, источник доверенного поколения БД
Выдача доступа и мониторинг /mcp Существующий вход через портал, политики, отзыв, аудит, UI/API Непустые IPsec SA или трёхузловая передача трафика
Инструменты существующих разделов Общие сервисы, права и область доступа, проверки конкретного сервиса Полная переаттестация независимых подсистем для каждого чтения
Изменения и выдача чувствительных файлов Точный план, подтверждение или явный допуск, повторная проверка прав, блокировки, запрет повтора unknown, выдача владельцу Автономный контроллер маршрутизации для независимого скачивания файла
Защищённое восстановление БД Сохранность отзыва доступа и control вне backup, доказанный исходный baseline, остановка записей и безопасный запуск в выбранной модели Протокольный SDK сам по себе этого не требует; это отдельная опасная функция
Автономный Route AI/recovery Общий бюджет всех переключений, резерв обратного действия, свежие сетевые доказательства и управляющий канал Самостоятельная система автоматики включена в общий согласованный план
Home → Jump → Exit и сложный VPN/VRF traffic Реальные узлы и двусторонние пакетные доказательства Парные конфигурационные проверки не заменяют эти доказательства
Работа всей установки в 2 ГБ Совместная измеренная нагрузка приложения, UI, PostgreSQL и сборщиков Размер тестового процесса TSX и статический Compose не доказывают бюджет рабочего процесса

Где сложность была внесена архитектурой

Подпись полного SQL-каталога, разделение PostgreSQL-актёров, защищённый реестр и внешнее подтверждение поколения БД — выбранная усиленная модель защиты. Их нельзя объяснять как обязательные зависимости самого MCP-протокола. Эти компоненты относятся к заявленной модели доверенного восстановления, переноса старых данных и запуска. Убирать их требования или заменять неподтверждённую гарантию более слабой без изменения согласованной модели нельзя.

Часть доработок общих сервисов оправдана: два входа REST/MCP должны одинаково исполнять права, бюджеты и полный набор эффектов. Часть выявленных проблем относится к тестовой оснастке. Например, backup штатно возобновляет фоновые задачи; в последнем UI-прогоне две Node-попытки были заблокированы ещё при создании backup. GeoIP с двумя загрузками — кандидат по коду, но конкретный источник ещё не доказан. Оснований менять MCP transport или выключать общие сервисы пока нет.

Как продолжать без нового разрастания

  1. Каждый открытый критерий связывать с конкретной функцией и исходным требованием. Новое ограничение или механизм должен иметь явную причину.
  2. Отдельно фиксировать реализацию, локальную приёмку, сетевую и внешнюю приёмку, эксплуатационные ограничения. Их нельзя выдавать за один процент готовности.
  3. Сначала закрывать короткие критерии в существующей архитектуре и общих сервисах. Перед введением нового слоя проверять, какой конкретный непройденный инвариант он закрывает и есть ли готовый механизм.
  4. Полноту интервала логов, третий узел, реальный портал и 2 ГБ учитывать у зависимых функций. Они остаются требованиями полного плана, но не размножаются в других разделах.
  5. Изолировать дефекты диагностики коротким тестом, где это возможно. Проверки сохранять до доказательства корректности результата.

Текущие проверяемые результаты и именованный остаток. Машиночитаемый аудит с хешами источников.