Инструменты по категориям
NKDK дает агенту не read-only-карточки объектов, а отдельное редактируемое YAML-представление файловой конфигурации с двусторонним преобразованием XML. В metadata-категории учитываются все восемь MCP tools, потому что они образуют единый жизненный цикл одного YAML/XML-проекта, а не независимые функции форм, СКД или BSL.
MCP tools по метаданным
nkdk.get_schema | возвращает summary или JSON Schema целевого YAML-файла; поддерживает выбор ключей, required-полей и поиск по схеме. |
|---|---|
nkdk.describe_project_structure | описывает допустимые каталоги и файлы проекта, их назначение, обязательность и повторяемость с ограничением глубины. |
nkdk.validate_project | проверяет весь YAML-проект или один файл и возвращает errors/warnings с путем, строкой и колонкой; project-wide режим проверяет структурные ссылки и DataPath. |
nkdk.import_from_xml | импортирует XML-выгрузку в YAML только при явном allowWrite=true. |
nkdk.sync_to_xml | без записи строит план; с разрешением выполняет полную либо state-based инкрементальную синхронизацию и сообщает добавленные, измененные и удаленные XML-файлы. |
nkdk.init_sync_state | явно создает .nkdk-sync.yaml, необходимый для инкрементального режима. |
nkdk.rename_item | планирует или выполняет переименование верхнеуровневого объекта либо дочернего элемента, сохраняя identity через migration. |
nkdk.delete_item | планирует или удаляет объект/дочерний элемент из YAML; физическое удаление из XML происходит при последующей синхронизации. |
Сильные стороны
формат и схемы предназначены для работы ИИ-агента; есть не только XML→YAML import, но и контролируемый round-trip обратно, project-wide validation ссылок, dry-run для опасных операций, инкрементальный state и отдельные guides/prompts MCP. Модель покрывает верхнеуровневые объекты, вложенные элементы, формы, роли, модули, макеты и другие файлы конфигурации без необходимости держать XML целиком в контексте агента.
Ограничения
ранняя стадия и заявленная совместимость только с платформой 8.3.27; это файловый снимок, а не живая база или EDT workspace. Универсальные tools работают со всем YAML-проектом, поэтому отдельное включение того же набора в категории «Формы» и «СКД и отчеты» создало бы ложное дублирование. Обратная синхронизация действительно пишет и удаляет XML-файлы; allowWrite, plan-mode и отдельный reference-каталог уменьшают риск, но не заменяют резервную копию и просмотр плана.
Когда выбирать
когда агент должен существенно редактировать файловую конфигурацию через компактный YAML, валидировать связи и затем получить контролируемую XML-выгрузку для загрузки в 1С.
Что учитывать
@nkdk/mcp версии 0.0.3 запускается через npx -y @nkdk/mcp; HTTP transport не реализован. Сервер дополнительно регистрирует 4 статических guide resources с URI nkdk://guides/... и 4 prompts для редактирования, импорта, обратной синхронизации и проверки YAML-проекта.engines. Заявлена совместимость с платформой 1С 8.3.27; проверка описана на шести конфигурациях, включая БП КОРП, УТ, ERP.УХ, ДО и УНФ.allowWrite=true: импорт и инициализация sync-state без него возвращают требование подтверждения; переименование и удаление сначала возвращают план. sync_to_xml без разрешения записи строит план изменений; для инкрементальной записи нужен .nkdk-sync.yaml, а полный режим включается явно через fullSync=true. Переименование сохраняет внутреннюю XML/reference identity через migration, удаление YAML-узла переносится в XML при последующей синхронизации. Обратная синхронизация может добавлять, изменять и удалять XML-файлы, поэтому reference/output-каталоги нужно проверять до разрешения записи. GitHub Releases содержит релизы v0.0.1-v0.0.3 без готовых desktop-артефактов для текущей версии; основная поставка MCP — npm-пакет размером около 32 MB в распакованном виде.