Инструменты по категориям

Метаданные извлекаются непосредственно из бинарных файлов конфигурации, расширения, обработки или отчёта. Распаковка создаёт организованное дерево объектов; это собственное представление контейнера, а не штатная XML-выгрузка Конфигуратора.

Инструменты в этой категории

unpack, unpack_asyncраспаковка файла в отдельный каталог.
list_objectsвиды и имена объектов.
get_metadataсводка контейнера либо сведения конкретного объекта.
search_code(layers=["forms"])текстовый поиск по JSON-заголовкам, реквизитам и элементам форм.
diffизменённые, добавленные и удалённые объекты между двумя деревьями.
repack, repack_asyncсборка бинарного файла после файловых правок.

Ограничения

Нет специализированного графа связей или анализа прав ролей. Изменения не загружаются в базу; добавление/удаление объектов требует согласованных ссылок в корневом представлении.

Сервер распаковывает бинарный файл 1С во временное дерево JSON/BSL и исходный raw-слой. Агент читает и правит это дерево, затем собирает новый бинарный файл; платформу 1С или EDT запускать не нужно.

Инструменты в этой категории

unpack, unpack_async, job_statusполучение рабочего дерева и контроль фоновой распаковки.
read_module, get_module_structureтекст модуля, диапазоны строк, процедуры, параметры и директивы.
search_codeподстрока или regex по выбранным текстовым слоям.
read_bytecode, find_closed_modules, decompile_modulesанализ и декомпиляция доступного байт-кода закрытых модулей.
diffпообъектное сравнение распакованных версий.
repack, repack_async, cleanupсборка из изменённого дерева и удаление временных каталогов.

Ограничения

Нет графа вызовов, LSP или синтаксической проверки BSL. Декомпиляция меняет рабочее дерево и не гарантирует компилируемый результат. Обычные правки файлов выполняются средствами агента.

Сервер читает справку, которая уже встроена в объект конфигурации, обработку или отчёт. Это сохранённый HTML по выбранному объекту; инструмент не строит бизнес-описание автоматически.

Инструменты в этой категории

get_helpналичие, HTML-содержимое и языки справки выбранного объекта.
set_helpзапись HTML в raw-слой, с отдельным флагом перезаписи существующей справки.
repackвключение изменений справки в новый бинарный файл.

Ограничения

Полезность зависит от наличия документации внутри файла. Полнотекстового семантического слоя по конфигурации нет; при изменении организованного дерева того же объекта raw-правка справки может не попасть в сборку.

Формы извлекаются из бинарного контейнера вместе с объектом-владельцем. Для поддержанных форм доступны JSON дерева элементов и BSL-модуль, которые агент может исследовать и изменить как файлы.

Инструменты в этой категории

get_metadataсписок форм и модулей объекта.
read_module, get_module_structureчтение и структура модуля формы.
search_code(layers=["forms"])поиск по JSON элементов и привязок.
diffсравнение содержимого форм между версиями.
repackсборка объекта после файлового изменения формы.

Ограничения

Нет отдельного конструктора или валидатора формы. Элементы управляемых форм формата 802 не разбираются: сохраняется сырой блок, доступен модуль. Изменение формы не доказывает её корректность или внешний вид в 1С.

Сервер извлекает макеты из распакованного контейнера. СКД читается из бинарного блока с XML, MXL декодируется в структурное представление. Для изменения макета используется импорт готового содержимого и последующая сборка файла.

Инструменты в этой категории

read_dcsобзор схемы, параметры, наборы данных, запрос и поля выбранного набора, XML настроек варианта.
export_dcsполный XML схемы в ответе либо в указанном файле.
import_dcsзамена схемы из XML-файла или строки в raw-слое.
read_templateструктура MXL и текстовые значения.
import_templateзамена существующего макета готовым MXL.
search_code(layers=["dcc"], scope="query" или "all")поиск в запросах либо полном XML СКД.

Ограничения

Нет исполнения отчёта, проверки запросов или генератора СКД. Если raw-макет и организованное дерево того же объекта изменены одновременно, repack отдаёт приоритет организованному дереву.

Что учитывать

Подключениелокальный STDIO MCP через v8unpack-mcp либо python -m v8unpack_mcp; каждый клиент запускает отдельный Python-процесс. Инструменты работают с путями к файлам и каталогам на машине сервера.
Что нужноPython 3.10+, зависимости mcp>=2.0 и tqdm; локальные файлы .cf, .cfe, .epf или .erf и место для временной распаковки. Ядро распаковки входит в пакет. Платформа 1С, EDT, внешняя база данных и сетевой сервис для этих операций не требуются.
Важноunpack создаёт временный каталог с организованным деревом JSON/BSL/форм/макетов и исходным raw-слоем; остальные операции принимают этот каталог без неявной распаковки. repack сохраняет неизменённые объекты из raw, а изменённые пересобирает; правки raw и организованного дерева одного объекта не объединяются: приоритет получает организованное дерево. Редактирование BSL и структуры выполняется файловыми средствами агента, отдельного write_module нет. decompile_modules заменяет доступные закрытые модули текстом в рабочем дереве и удаляет их бинарные копии; обфусцированные модули и модули без байт-кода пропускаются, компиляция результата платформой не гарантируется. Дерево элементов управляемых форм старого формата 802 не разбирается. Сборка не импортирует файл в информационную базу и не доказывает его работоспособность. Временный каталог после сборки остаётся до cleanup.