1c-meta MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
1c-meta — создание и правка метаданных 1С в выгрузке конфигуратора и проекте EDT
Инструмент для ИИ-агентов: создаёт и правит метаданные, формы и код BSL в выгрузке конфигуратора и в проекте 1C:EDT. Каналов два — командная строка (CLI) и MCP-сервер, задание у них одно. Инструмент пишет файлы выгрузки так же, как их пишет конфигуратор, и не даёт нарушить правила, которые иначе всплывают только при загрузке в базу.
Проверено двумя способами: сборкой обратно (побайтно) всех существующих объектов выгрузки крупной типовой конфигурации и кругом «записали → загрузили конфигуратором → выгрузили обратно», в котором платформа не меняет ни символа.
Лицензия — MIT (LICENSE); сторонние компоненты — THIRD_PARTY_NOTICES.md.
Оглавление
Справка в
docs/: запуск из командной строки · MCP-сервер · объекты метаданных · формы · правка кода · проверка правок и сверка плана · проект EDT · внешние обработки и отчёты · профиль соглашений · чего нет · устройство и проверки · словарь
Related MCP server: xbsl-mcp
Установка
Нужны Python 3.10 или новее (проверено на 3.13) и git в PATH. Пакеты:
py -3 -m pip install "lxml>=5.0" # всегда: разбор и сборка файлов выгрузки
py -3 -m pip install "mcp>=1.29" # только для MCP-сервера (pydantic придёт с ним)
py -3 -m pip install pytest ruff # только для проверокНа Linux и macOS вместо py -3 — python3. Инструмент запускается из каталога
репозитория как есть; пакетом для pip install он не оформлен. pyproject.toml
хранит настройки ruff и pytest и метаданные проекта, а установка — как описано
в этом разделе.
Для проекта 1C:EDT нужна ещё таблица метамодели EDT — порядок и умолчания свойств объектов и форм. В репозитории её нет: она снимается с моделей установленного 1C:EDT, на той машине, где инструмент работает:
py -3 tools/edt_model_from_xcore.py # без аргумента — пул p2: %USERPROFILE%\.p2\pool\pluginsПолучится meta/acl/edt_metamodel.py (в .gitignore). Без неё выгрузка
конфигуратора работает полностью, у проекта EDT работают проверки и
нормализация, а запись и показ отклоняются с этой же подсказкой.
Таблицу снимают заново после обновления EDT и после обновления инструмента,
если в нём менялся список моделей скрипта (так, с поддержкой расширения
конфигурации в неё вошли модели расширения).
Выгрузка — каталог, который пишет конфигуратор командой «Конфигурация → Выгрузить конфигурацию в файлы». Результат загружается обратно командой «Загрузить конфигурацию из файлов» — целиком, а не частично (раздел «Ограничения»).
Быстрый старт
Командная строка
Задание — файл JSON: куда писать (repo — каталог выгрузки, где лежит
Configuration.xml) и что сделать. Для пробы годится пустая выгрузка: скопируйте
meta/tests/эталоны/формы/Configuration.xml в пустой каталог и укажите его
в repo. Примеры дальше ссылаются и на типовые объекты (Справочник.Организации
и другие) — в пустой выгрузке их нет, и такие ссылки получат ТИП-НЕТ, пока
объекты не заведены. Справочник с одним реквизитом:
{"repo": "C:/путь/к/выгрузке/cf",
"objects": [
{"вид": "Справочник",
"поля": {"имя": "мой_Пример", "синоним": "Пример",
"реквизиты": [
{"имя": "Комментарий", "синоним": "Комментарий",
"тип": {"вид": "Строка", "длина": 100}}]}}]}Сохраните его в UTF-8 как задание.json и посмотрите, что будет сделано, —
на диск при этом не пишется ничего:
py -3 meta/add.py задание.jsonВыгрузка: C:/путь/к/выгрузке/cf
Справочник мой_Пример
замечаний нет
синоним: Пример
реквизиты: Комментарий «Комментарий» (Строка(100))
(ещё 50 полей не названы в задании — значения по умолчанию; …)
План:
создать C:\путь\к\выгрузке\cf\Catalogs\мой_Пример.xml (6150 Б)
изменить C:\путь\к\выгрузке\cf\Configuration.xml (станет … Б, было … Б)
Просмотр: ничего не записано. Для записи повторите с --apply.План тот — записываем:
py -3 meta/add.py задание.json --applyКлючи командной строки — в docs/cli.md.
MCP-сервер
Второй канал — тот же инструмент для агентов, у которых нет оболочки. Сервер
подключается в настройках MCP-клиента; у Claude Code — файл .mcp.json проекта,
ключ mcpServers:
{"mcpServers": {
"1c-meta": {"type": "stdio", "command": "py",
"args": ["-3", "C:\\путь\\к\\1c-meta\\meta\\mcp_server.py"],
"env": {"META_ROOTS": "C:\\путь\\к\\проекту1\\cf;C:\\путь\\к\\проекту2\\cf",
"META_PROFILE": "C:\\путь\\к\\профиль.json"}}}}py -3 — запуск Python на Windows; на Linux и macOS — "command": "python3"
и путь к mcp_server.py без -3. Разделитель путей в META_ROOTS — «;».
META_ROOTS — белый список: сервер работает только с выгрузками из него, и на
чтение, и на запись; без настройки отказ получает любой инструмент с repo,
работает только справка fields. META_PROFILE — путь к профилю соглашений
команды (docs/profile.md); без профиля соглашения нейтральные.
То же задание принимает MCP-сервер: metadata_check — просмотр,
metadata_apply — запись (раздел «MCP-сервер для агентов»:
там все инструменты сервера).
Что умеет
Объекты метаданных — 15 видов: создать сразу с содержимым (реквизиты, табличные части, измерения и ресурсы, права роли), добавить вложенную сущность, изменить свойство, удалить с поиском ссылок, переименовать со всеми ссылками, завести атомарные роли — docs/metadata.md.
Управляемые формы — новая или существующая форма: реквизиты, команды, элементы пятнадцати видов, обработчики; для типовой формы — код доработки вместо правки XML — docs/forms.md.
Код BSL вставками — метки с датой, задачей и автором, комментирование заменяемого кода, откат вставок задачи, переименование и перенос метода — docs/code.md.
Проверка правок задачи, нормализация формата файлов и сверка плана изменений с фактом — docs/verify.md.
Проект 1C:EDT и расширение конфигурации — docs/edt.md.
Внешние обработки и отчёты в их собственной выгрузке — docs/external.md.
Профиль соглашений команды — приставка, метки, атомарные роли, уровни правил — docs/profile.md.
Полная таблица операций — в docs/metadata.md.
Ограничения
Формат выгрузки — 2.21, то есть платформа 8.5. Выгрузку другого формата инструмент читает, но метаданные и формы в неё не пишет (раздел «Запуск»).
Загрузка обратно — только полная. Служебный
ConfigDumpInfo.xmlинструмент не правит: его пересобирает платформа при загрузке.Заведено 15 видов объектов конфигурации из 43 (и внешние обработка с отчётом) и 15 видов элементов форм из 31; чего нет, перечислено в разделе «Чего нет».
Проект EDT поддерживается наравне с выгрузкой; оговорки — в разделе «Проект EDT».
Внешние обработка и отчёт — в своей выгрузке, без удаления и переименования; оговорки — в разделе «Внешняя обработка и отчёт».
Язык
Русский — в данных и в том, что видит пользователь: имена видов и свойств метаданных 1С, поля заданий, значения перечислений, коды и тексты находок, сообщения; комментарии в коде — тоже по-русски. Часть внутренних имён в коде (функций, классов, переменных) пока русская — это наследие ранних версий, их переводим на английский; новые имена пишутся по-английски.
Лицензия
MIT — LICENSE. Сторонние компоненты и их лицензии — THIRD_PARTY_NOTICES.md.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Enforces architectural invariants and code quality rules inside your AI agent's edit loop.
Turn an idea or meeting transcript into a working single-file AI agent, check it, use it right away.
Turn an idea or meeting transcript into a working single-file AI agent, check it, use it right away.
Turn an idea or meeting transcript into a working single-file AI agent, check it, use it right away.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with 1C:Enterprise databases through natural language, providing metadata retrieval, configuration analysis, and code generation.9-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to lint, search documentation, and perform metadata scaffolding for 1C:Element projects.5,798 PyPI3MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to interact with 1C: Enterprise development environment, including running tests, managing launch profiles, building configurations, and performing database operations through the 1C: Platform Tools extension.46MIT
- FlicenseNot gradedqualityAmaintenanceEnables 1C:Enterprise development with 74 tools for static analysis, code audit, query validation, EPF verification, and configuration management using local XML exports without a running database.2-