onec-cfg2md
CLI на Go, который конвертирует выгрузку метаданных конфигурации 1С в формате CFG или EDT в читаемый Markdown
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает локальные файлы выгрузки и пишет Markdown и CSV, не подключается к базе
- Не выполняет код 1С и не изменяет исходную конфигурацию
Установка
Ручная установка
go build -o bin/onec-cfg2md .Сборка из исходников после git clone и go mod tidy.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Утилита автоматически распознает формат выгрузки: CFG (XML-файлы конфигуратора с Configuration.xml в корне) или EDT (файлы MDO с .project и src/ в корне), и генерирует по одному Markdown-файлу на каждый объект метаданных с его реквизитами шапки и табличными частями, плюс общий CSV-каталог objects.csv со сводкой по всем объектам. Поддерживаются документы, справочники, перечисления, планы видов характеристик, регистры накопления и сведений, константы и критерии отбора, набор типов можно ограничить флагом --types. Результат предназначен для подключения к MCP или другому агентскому инструменту, которому нужен текстовый контекст по структуре конфигурации без разбора сырого XML или MDO.
Для кого. Для 1С-разработчиков, которым нужен компактный текстовый контекст по метаданным конфигурации для агента или другого MCP-инструмента.
Подходит, если
- Нужно скормить агенту описание объектов метаданных без разбора сырого XML или MDO
- Есть выгрузка в CFG или EDT формате и нужен единый читаемый вид
- Нужен CSV-каталог всех объектов конфигурации для быстрого обзора
Не подходит, если
- Нужен не текстовый обзор, а полноценный MCP-доступ к живой базе с запросами
- Нужна конвертация модулей BSL, а не только объектов метаданных: утилита их не обрабатывает
Пример запроса к агенту
Сконвертируй мою выгрузку конфигурации из EDT в Markdown и покажи структуру документа ЗаказОграничения
Утилита сама по себе не MCP-сервер: она генерирует файлы для последующего использования в MCP или другом инструменте. README не описывает пакетной сборки под разные ОС, только go build из исходников. Поддерживаются только восемь типов метаданных 1С, перечисленных в таблице README.
Как отключить. Просто не запускайте бинарник onec-cfg2md и удалите сгенерированные Markdown и CSV файлы, если они больше не нужны.
Проверка безопасности
- Только читает локальные файлы выгрузки и пишет Markdown и CSV, не подключается к базе
- Не выполняет код 1С и не изменяет исходную конфигурацию
Коротко о README
README перечисляет поддерживаемые форматы (CFG, EDT) и восемь типов метаданных с их CLI-ключами, дает команды установки через go build, примеры запуска с флагами --format, --types и --verbose, шаблон имени и содержимого выходных Markdown-файлов, формат objects.csv, структуру проекта на Go (cmd, pkg/detector, pkg/generator, pkg/parser) и команды make для сборки и тестов.
Частые вопросы
Нужно ли указывать формат вручную?
Нет, утилита определяет формат автоматически, но можно принудительно задать флагом --format=cfg или --format=edt.
Можно обработать только документы?
Да, флагом --types=documents ограничивается набор обрабатываемых типов метаданных.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything