MCP-сервер данных 1С с защитой от вранья
gf-data-1c
Read-only MCP-сервер на Rust к данным баз 1С:Предприятие: предупреждает о тихих ловушках в запросах, текст запроса пишет платформа, а не модель
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только чтение по дизайну, запрос на изменение отклоняется до обращения к базе
Установка
Ручная установка
gfdata.exe -install "C:\путь\к\базе" -db-user <пользователь> -db-password <пароль>Ставит расширение в файловую или серверную базу, бинарь несет расширение внутри себя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер ставит расширение в базу 1С и через него читает данные: остатки, обороты, срезы регистра сведений, итоги по бухгалтерским счетам, справочники и подсчет записей. Он устроен вокруг четырех решений против конкретных случаев вранья модели: предупреждает о тихих ловушках запроса вроде сравнения ссылки со строкой или остатка на начало дня без времени, разрешает выполнять только текст запроса, собранный тем же инструментом query_build в этой сессии, дополняет отказ платформы подсказкой с составом полей и заменами несуществующих конструкций языка, и отдает справку синтаксиса и членов типов прямо из документации установленного релиза, а не по памяти модели. Отказ инструмента никогда не выглядит как пустой результат, а база всегда называется явно: вызов без нее отклоняется схемой.
Для кого. Для разработчиков и аналитиков 1С, которых беспокоит, что агент может выдать правдоподобный, но неверный отчет по данным базы.
Подходит, если
- Нужен read-only доступ к остаткам, оборотам или бухгалтерским итогам через агента
- Нужна защита от тихих ошибок запроса вроде сравнения ссылки со строкой
- Нужна точная справка по языку запросов и объектам конкретного установленного релиза
Не подходит, если
- Нужна запись данных: сервер только читает по дизайну и отклоняет изменяющие запросы до обращения к базе
- Конфигурация не русскоязычная: перевод в запросную нотацию рассчитан на русские префиксы имен
Пример запроса к агенту
Покажи остатки товара Цемент М400 на основном складе на сегодня и сверь с бухгалтерскими итогамиОграничения
Только русскоязычные конфигурации по дизайну. Только чтение, изменения отклоняются до обращения к базе. Сборка со встроенным расширением требует собственный инструментарий сборки объектов 1С, которого нет у стороннего разработчика: без него ставить расширение нужно готовым файлом dist/GTData.cfe. Ответ базы крупнее 128 МиБ отклоняется с отказом.
Как отключить. Уберите базу из реестра сервера командой bases action=remove и удалите расширение GTData из конфигурации базы.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TOKEN секрет | Bearer-токен для сетевого HTTP-режима, пусто означает отсутствие проверки. |
| DATA_DIR | Каталог для реестра баз и журнала в контейнерном режиме. |
Проверка безопасности
- Только чтение по дизайну, запрос на изменение отклоняется до обращения к базе
Коротко о README
README подробно объясняет философию продукта: четыре механизма против конкретных случаев, когда агент выдавал правдоподобный, но неверный ответ, таблицу из тринадцати инструментов, установку расширения через gfdata.exe -install или готовый .cfe, регистрацию базы в реестре с защитой паролей через DPAPI на Windows, запуск в контейнере с явными предупреждениями об отсутствии расширения и защиты паролей в Linux, и диагностику через probe с проверкой рассинхрона версий.
Частые вопросы
Может ли сервер что-то изменить в базе?
Нет, запрос на изменение отклоняется до обращения к базе, это свойство продукта, а не только ограничение прав.
Что если агент сам придумает текст запроса?
Инструмент query выполнит только текст, который в этой же сессии собрал query_build, произвольный текст от модели отклоняется.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики