kd-rules-mcp
MCP-сервер правил обмена 1С: агент читает, собирает, правит и проверяет правила «Конвертации данных» 2 и 3
- 30 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер пишет правила обмена и расширения в папки проектов 1С, которые указаны в `projects.yaml`.
- Контейнеру открывают папки проекта и обмена на локальной машине.
Установка
- Работает в
- Сервисы
Ручная установка
docker compose up -dПеред запуском возьмите тег релиза, скачайте `docker-compose.yml` и примеры `projects.example.yaml`, выполните `setup` образа и заполните `projects.yaml`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер пишет правила обмена и расширения в папки проектов 1С, которые указаны в `projects.yaml`.
- Контейнеру открывают папки проекта и обмена на локальной машине.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер читает XML-выгрузки конфигураций 1С, данные базы ему не нужны, и работает с правилами обмена в двух поколениях «Конвертации данных». Для «Конвертации данных 2» он читает и пишет `ПравилаОбмена` формата 2.01, подсказывает кандидатов сопоставления, правит правила конвертации, свойств и регистрации. Для «Конвертации данных 3» на универсальном формате EnterpriseData он разбирает модуль менеджера обмена, сверяет его со схемой формата и конфигурацией, дорабатывает типовой обмен расширением и переносит правила регистрации с версии 2. Сервер детерминированный: что во что конвертировать, решает агент, а результат виден в отчете и дифф-сравнении `rules_diff`. Проверка `rules_validate` находит, например, значения типов без правила конвертации. Рядом с сервером в репозитории лежат четыре скилла: установка, ловушки обменов КД 2, сборка правил КД 2 и правила КД 3.
Для кого. 1С-разработчикам, которые настраивают обмен между конфигурациями и хотят вести правила через агента вместо «Конвертации данных»
Подходит, если
- В обмен надо добавить справочник, и правила сопоставления хочется собрать по метаданным двух конфигураций.
- Контрагенты задваиваются при обмене, и причину ищут в правилах конвертации.
- Типовой обмен на КД 3 дорабатывают расширением, и модуль менеджера обмена надо сверить со схемой формата.
- Правила регистрации с КД 2 переносят на универсальный формат.
Не подходит, если
- Правила правят на боевых базах: сервер работает с выгрузками, живой обмен проверяется только между песочницами.
- Docker на машине нет, а разворачивать сервер из клона через `uv` не хочется.
- Обмен построен без «Конвертации данных» и EnterpriseData.
Пример запроса к агенту
Добавь справочник Номенклатура в обмен с Бухгалтерией и покажи дифф правил, после чего прогони проверкуMCP
- Транспорт
- http
- Авторизация
- не нужна
Ограничения
Для готового образа нужен Docker с Compose, для сборки из клона Python 3.12 и `uv`. Необязательные финальные проверки живого обмена требуют Windows с платформой 1С 8.3. Перед запуском заполняют `projects.yaml` и `projects.local.yaml` с абсолютными путями своей машины. Сервер лишь разбирает выгрузки и правила, а решения о сопоставлении принимает агент, поэтому результат стоит просматривать в дифф-сравнении. Автор указывает, что боевые базы проверки не затрагивают.
Как отключить. Остановите контейнер командой `docker compose down` и удалите сервер из `.mcp.json` или настроек MCP в Cursor.
Частые вопросы
Как поставить kd-rules-mcp в Claude Code?
Поднимите контейнер из релизного образа командой `docker compose up -d`, затем запустите `claude` в папке и одобрите серверы из `.mcp.json`. Проверить подключение можно командой `claude mcp list`.
Нужна ли база 1С и «Конвертация данных»?
Нет. Сервер читает XML-выгрузки конфигураций, и программа «Конвертация данных» для работы не требуется.
Чем КД 3 отличается от КД 2 для сервера?
Для КД 2 сервер работает с `ПравилаОбмена` формата 2.01, для КД 3 разбирает модуль менеджера обмена на универсальном формате EnterpriseData.
Что показывает проверка правил?
Команда `rules_validate` выводит число ошибок и предупреждений с кодом и местом, например отсутствие ПКО для типов справочника. После правки `rules_diff` показывает, что изменилось.
Какие скиллы идут в комплекте?
Четыре: `kd-install` для установки, `kd2-exchange-pitfalls`, `kd2-rules-build` и `kd3-rules`. Их собирают в архивы релиза для Claude Code, Cursor, OpenCode и Codex.
Обсуждение
Вопросов и отзывов пока нет.
Rules MCP: разбор правил обмена 1С
rules-mcp
MCP-сервер разбирает правила обмена 1С формата Конвертация данных 2.0 и отвечает на вопросы о них в чате, без модели в самом разборе
Набор правил, субагентов, скиллов и MCP-интеграций для разработки на 1С:Предприятие 8 с Cursor, Claude Code, Codex и другими агентами
Docker-сервер с read-only ядром и подключаемыми модулями: метаданные, код, формы и связи нескольких конфигураций 1С через единый MCP-контракт
MCP-сервер конфигураций 1С
1C Config MCP Server
MCP-сервер и портативный администратор для анализа выгруженной XML-конфигурации 1С: поиск объектов, структура метаданных, поиск по коду
MCP стандартов разработки 1С
MCP-сервер стандартов разработки 1С:Предприятие 8
MCP-сервер с официальными стандартами и методиками разработки 1С:Предприятие 8 для поиска и проверки кода агентом
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
Коротко о README
README показывает пример проверки правил, перечисляет возможности для КД 2 и КД 3 и дает два способа установки: готовый образ с Docker и сборку из исходников. Отдельно описаны скиллы и подключение к папке проекта 1С.