MCP-сервер данных 1С с защитой от вранья
gf-data-1c
Read-only MCP-сервер на Rust к данным баз 1С:Предприятие: предупреждает о тихих ловушках в запросах, текст запроса пишет платформа, а не модель
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Устанавливает в базу 1С расширение GTData, для этого нужен логин и пароль базы
- Выполняет запросы к остаткам, оборотам, справочникам и бухгалтерским итогам
- Запросы на изменение данных отклоняет до обращения к базе
Установка
- Работает в
- Сервисы
Ручная установка
gfdata.exe -install "C:\путь\к\базе" -db-user <пользователь> -db-password <пароль>Ставит расширение в файловую или серверную базу, бинарь несет расширение внутри себя.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Устанавливает в базу 1С расширение GTData, для этого нужен логин и пароль базы
- Выполняет запросы к остаткам, оборотам, справочникам и бухгалтерским итогам
- Запросы на изменение данных отклоняет до обращения к базе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер ставит расширение в базу 1С и через него читает данные: остатки, обороты, срезы регистра сведений, итоги по бухгалтерским счетам, справочники и подсчет записей. Он устроен вокруг четырех решений против конкретных случаев вранья модели: предупреждает о тихих ловушках запроса вроде сравнения ссылки со строкой или остатка на начало дня без времени, разрешает выполнять только текст запроса, собранный тем же инструментом query_build в этой сессии, дополняет отказ платформы подсказкой с составом полей и заменами несуществующих конструкций языка, и отдает справку синтаксиса и членов типов прямо из документации установленного релиза, а не по памяти модели. Отказ инструмента никогда не выглядит как пустой результат, а база всегда называется явно: вызов без нее отклоняется схемой.
Для кого. Для разработчиков и аналитиков 1С, которых беспокоит, что агент может выдать правдоподобный, но неверный отчет по данным базы.
Подходит, если
- Нужен read-only доступ к остаткам, оборотам или бухгалтерским итогам через агента
- Нужна защита от тихих ошибок запроса вроде сравнения ссылки со строкой
- Нужна точная справка по языку запросов и объектам конкретного установленного релиза
Не подходит, если
- Нужна запись данных: сервер только читает по дизайну и отклоняет изменяющие запросы до обращения к базе
- Конфигурация не русскоязычная: перевод в запросную нотацию рассчитан на русские префиксы имен
Пример запроса к агенту
Покажи остатки товара Цемент М400 на основном складе на сегодня и сверь с бухгалтерскими итогамиMCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
TOKENсекрет- Bearer-токен для сетевого HTTP-режима, пусто означает отсутствие проверки.
DATA_DIR- Каталог для реестра баз и журнала в контейнерном режиме.
Ограничения
Только русскоязычные конфигурации по дизайну. Только чтение, изменения отклоняются до обращения к базе. Сборка со встроенным расширением требует собственный инструментарий сборки объектов 1С, которого нет у стороннего разработчика: без него ставить расширение нужно готовым файлом dist/GTData.cfe. Ответ базы крупнее 128 МиБ отклоняется с отказом.
Как отключить. Уберите базу из реестра сервера командой bases action=remove и удалите расширение GTData из конфигурации базы.
Частые вопросы
Может ли сервер что-то изменить в базе?
Нет, запрос на изменение отклоняется до обращения к базе, это свойство продукта, а не только ограничение прав.
Что если агент сам придумает текст запроса?
Инструмент query выполнит только текст, который в этой же сессии собрал query_build, произвольный текст от модели отклоняется.
Обсуждение
Вопросов и отзывов пока нет.
Универсальный MCP-сервер 1С (только чтение)
Universal 1C MCP Server (Read-Only)
Строго read-only MCP-сервер поверх HTTP-сервиса 1С: 39 инструментов для метаданных, запросов, бухгалтерии и отчетов
Бесплатный MCP-сервер для рабочей базы 1С: агент читает данные по обычной просьбе и получает структуру метаданных любой конфигурации
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL
Один бинарь на Rust без зависимостей и сети: индексирует выгрузку конфигурации 1С и отвечает на вопросы о графе вызовов и метаданных за миллисекунды
Коротко о README
README подробно объясняет философию продукта: четыре механизма против конкретных случаев, когда агент выдавал правдоподобный, но неверный ответ, таблицу из тринадцати инструментов, установку расширения через gfdata.exe -install или готовый .cfe, регистрацию базы в реестре с защитой паролей через DPAPI на Windows, запуск в контейнере с явными предупреждениями об отсутствии расширения и защиты паролей в Linux, и диагностику через probe с проверкой рассинхрона версий.