MCP-сервер структуры конфигураций 1С
MCP 1C
Docker-сервер с read-only ядром и подключаемыми модулями: метаданные, код, формы и связи нескольких конфигураций 1С через единый MCP-контракт
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Хранит и индексирует полный исходный код и структуру конфигураций 1С в собственном хранилище data/
- Требует администраторский токен с правами загрузки и удаления источников, компрометация которого раскрывает всю базу знаний
Установка
Ручная установка
cp .env.example .env
docker compose up -dПосле заполнения .env двумя разными токенами API_TOKEN и ADMIN_TOKEN.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер разбирает выгрузки конфигураций 1С (структуру, код, формы, связи, виртуальные таблицы, справку платформы нескольких версий) и отдает их агенту через MCP, дашборд SPA и HTTP API. Постоянное read-only ядро можно расширить capability-модулями: Forms собирает Form.xml и Module.bsl по канонической спецификации, проверяет результат и декомпилирует обратно, ничего не меняя в конфигурации или базе, а Metadata Authoring создает и проверяет комплект метаданных объекта тоже без записи в конфигурацию или информационную базу, все операции модуля описаны как pure. Отключенный модуль не публикует свои инструменты и не занимает контекст MCP-клиента. Сервер держит несколько конфигураций одновременно и не путает их данные, работает одним контейнером Docker с обязательными разными токенами доступа и администратора и жестким non-root запуском.
Для кого. Для 1С-разработчиков с несколькими крупными конфигурациями, которым нужен постоянно работающий локальный сервер контекста для агента, а не разовый локальный процесс.
Подходит, если
- Ведется несколько конфигураций 1С одновременно, и агент должен явно выбирать нужную
- Нужен дашборд для человека, чтобы видеть источники, связи и состояние сервера, а не только API
- Нужна сборка формы по спецификации с проверкой, без прямой записи в конфигурацию
Не подходит, если
- Нет возможности развернуть Docker и подготовить каталог данных с правильным владельцем 10001:10001: README описывает это как обязательный шаг
- Нужна прямая запись изменений в конфигурацию или информационную базу: и Forms, и Metadata Authoring намеренно pure и только возвращают артефакты текстом
- Нужен race-free MXL-парсер: репозиторий не содержит исходные HBK и выгрузки, только рантайм над подготовленными источниками
Пример запроса к агенту
В конфигурации Розница найди все объекты, связанные с регистром ТоварыНаСкладах, и покажи граф связейОграничения
Официальный образ требует два разных случайных токена не короче 32 печатных ASCII-символов еще до старта, без них сервер не запускается даже на localhost. Каталог данных на Linux должен принадлежать UID:GID 10001:10001 заранее, обычный mkdir -p этого не дает. Репозиторий не содержит исходные HBK, выгрузки конфигураций и их индексы, все это готовится отдельно администратором и остается вне git. Одновременно поддерживается только одна тяжелая операция intake, вторая получает 409 до чтения тела запроса. Неподписанный или измененный артефакт общей справки получает статус untrusted и не открывается сервером.
Как отключить. Остановите контейнер командой docker compose down и удалите сервер из настроек MCP-клиента.
MCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| API_TOKEN обязательная, секрет | Токен доступа к MCP и дашборду, обязателен и не короче 32 символов. |
| ADMIN_TOKEN обязательная, секрет | Токен администратора для загрузки, удаления и перезагрузки источников, должен отличаться от API_TOKEN. |
| MCP1C_CAPABILITIES | Bootstrap набора включенных модулей при первом запуске, пока нет data/server-settings.json. |
Проверка безопасности
- Хранит и индексирует полный исходный код и структуру конфигураций 1С в собственном хранилище data/
- Требует администраторский токен с правами загрузки и удаления источников, компрометация которого раскрывает всю базу знаний
Коротко о README
README подробно описывает read-only ядро с подключаемыми capability-модулями Forms и Metadata Authoring, современный дашборд, модульную систему возможностей с новой MCP-сессией после включения модуля и очень подробный runbook разворачивания в Docker на чистом Linux: подготовка каталога данных с конкретным владельцем, обязательные два токена, режимы доступа local/http/https-proxy, различие Source A и Source B для загрузки конфигураций, двухфазный intake API с preview и явной публикацией, ограничения на размер загрузки и подписанный read-only артефакт общей справки платформы. Указан переход с версии 3.3.0 на 4.0.0.
Частые вопросы
Форма собирается сразу в конфигурацию?
Нет, модуль Forms возвращает Form.xml и Module.bsl текстом, конфигурацию или информационную базу сервер сам не меняет.
Можно работать с несколькими конфигурациями в одной установке?
Да, это одна из заявленных причин существования сервера: агент явно выбирает нужную конфигурацию и не получает данные другой случайно.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything