MCP-сервер структуры конфигураций 1С
MCP 1C
Docker-сервер с read-only ядром и подключаемыми модулями: метаданные, код, формы и связи нескольких конфигураций 1С через единый MCP-контракт
- 12 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Хранит и индексирует полный исходный код и структуру конфигураций 1С в собственном хранилище data/
- Требует администраторский токен с правами загрузки и удаления источников, компрометация которого раскрывает всю базу знаний
Установка
- Работает в
- Сервисы
Ручная установка
cp .env.example .env
docker compose up -dПосле заполнения .env двумя разными токенами API_TOKEN и ADMIN_TOKEN.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хранит и индексирует полный исходный код и структуру конфигураций 1С в собственном хранилище data/
- Требует администраторский токен с правами загрузки и удаления источников, компрометация которого раскрывает всю базу знаний
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер разбирает выгрузки конфигураций 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 и выгрузки, только рантайм над подготовленными источниками
Пример запроса к агенту
В конфигурации Розница найди все объекты, связанные с регистром ТоварыНаСкладах, и покажи граф связейMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
API_TOKENобязательная, секрет- Токен доступа к MCP и дашборду, обязателен и не короче 32 символов.
ADMIN_TOKENобязательная, секрет- Токен администратора для загрузки, удаления и перезагрузки источников, должен отличаться от API_TOKEN.
MCP1C_CAPABILITIES- Bootstrap набора включенных модулей при первом запуске, пока нет data/server-settings.json.
Ограничения
Официальный образ требует два разных случайных токена не короче 32 печатных ASCII-символов еще до старта, без них сервер не запускается даже на localhost. Каталог данных на Linux должен принадлежать UID:GID 10001:10001 заранее, обычный mkdir -p этого не дает. Репозиторий не содержит исходные HBK, выгрузки конфигураций и их индексы, все это готовится отдельно администратором и остается вне git. Одновременно поддерживается только одна тяжелая операция intake, вторая получает 409 до чтения тела запроса. Неподписанный или измененный артефакт общей справки получает статус untrusted и не открывается сервером.
Как отключить. Остановите контейнер командой docker compose down и удалите сервер из настроек MCP-клиента.
Частые вопросы
Форма собирается сразу в конфигурацию?
Нет, модуль Forms возвращает Form.xml и Module.bsl текстом, конфигурацию или информационную базу сервер сам не меняет.
Можно работать с несколькими конфигурациями в одной установке?
Да, это одна из заявленных причин существования сервера: агент явно выбирает нужную конфигурацию и не получает данные другой случайно.
Обсуждение
Вопросов и отзывов пока нет.
Набор MCP-серверов для 1С в Docker
MCP-серверы для 1С
Docker Compose с набором MCP-серверов для разработки 1С в Cursor: синтаксис, справка платформы, БСП, формы, графовый поиск по конфигурации
Единый MCP-шлюз для 1С с дашбордом
onec-mcp-universal
Docker-шлюз с одним адресом вместо нескольких MCP-подключений: данные 1С, навигация по BSL, поиск по ИТС через 1С:Напарник и веб-дашборд
Docker-развертывание MCP-серверов для 1С
MCP-серверы для 1С:Enterprise
Готовые Docker Compose файлы и скрипты управления для девяти MCP-серверов 1С:Enterprise: справка, метаданные, графовый поиск, проверка синтаксиса
1C MCP Suite: набор серверов для конфигурации 1С
1C MCP Suite
Пять независимых MCP-серверов на Docker: граф метаданных и вызовов в Neo4j, анализ BSL, справка платформы, конструктор запросов и стандарты
MCP-сервер метаданных 1С
1C_MCP_metadata
MCP-сервер поверх HTTP-сервиса расширения 1С: отдает структуру метаданных конфигурации, ищет объекты и проверяет синтаксис запросов
MCP-сервер конфигураций 1С
1C Config MCP Server
MCP-сервер и портативный администратор для анализа выгруженной XML-конфигурации 1С: поиск объектов, структура метаданных, поиск по коду
Коротко о 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.