Инструменты по категориям

Данные и запросы

onecscripting MCP подключает агента к файловым и серверным базам через Windows V83.COMConnector. Один сервер обслуживает несколько именованных профилей, кеширует соединения в worker-процессах и возвращает примитивные и сложные значения 1С как ограниченный по глубине и размеру typed JSON.

Возможности по данным и запросам

  • execute_query выполняет язык запросов 1С с параметрами, поддерживает таблицы значений и временные таблицы и возвращает выгруженную таблицу либо выборку;
  • execute_bsl исполняет ограниченный блок BSL через собственный parser/runtime поверх COM;
  • execute_bsl_module добавляет функции, процедуры, внутренние вызовы и выбираемую входную функцию, но не поддерживает полный язык платформы;
  • call_common_module вызывает доступные во внешнем соединении экспортные методы и возвращает также измененные аргументы для by-reference сценариев;
  • list_profiles, com_registration_status, health_check, reset_connection обслуживают выбор базы, COM registration и жизненный цикл соединений.

Сильные стороны

прямой доступ без установки расширения в базу; несколько профилей в одном сервере; отдельный query tool; поддержка ссылок, массивов, структур, соответствий, списков и таблиц значений; возможность переиспользовать существующие общие модули конфигурации.

Ограничения

Windows-only COM-контур и зависимость от версии зарегистрированной comcntr.dll; нет технического read-only режима, маскирования или approval. full_power присутствует в конфиге и диагностике, но не ограничивает tools в production-коде. Любой BSL-вызов или общий модуль следует считать потенциально изменяющим данные. Включенная по умолчанию автоматическая регистрация COM может запускать regsvr32 и менять системную регистрацию коннектора.

Когда выбирать

когда нужен локальный мультибазовый доступ через COM, запросы и вызовы прикладной логики, а права учетных записей и разрешение записей контролируются вне MCP-сервера.

Что учитывать

ПодключениеMCP Streamable HTTP на http://127.0.0.1:8765/mcp по умолчанию; transport можно переключить на STDIO или другой поддерживаемый FastMCP режим через конфиг или CLI.
Что нужноWindows, Python 3.10+, установленную платформу 1С с доступным V83.COMConnector, учетные данные и строку внешнего соединения к файловой или серверной информационной базе; пакетные зависимости Python. Для нескольких баз нужен JSON-конфиг с отдельными профилями; пароль рекомендуется передавать через указанную в профиле переменную окружения. Автоматическая регистрация нужной версии comcntr.dll через regsvr32 требует соответствующих прав Windows.
Важносервер поддерживает несколько профилей баз и кеширует COM-соединения в отдельных worker-процессах, сгруппированных по версии платформы. execute_query выполняет параметризованный язык запросов 1С и сериализует результаты в JSON. execute_bsl и execute_bsl_module не вызывают платформенный оператор Выполнить: код разбирается собственным ограниченным BSL-парсером и интерпретируется через Python/COM; поддерживаются условия, циклы, менеджеры объектов, запросы, встроенные функции и ограниченный модульный режим. call_common_module вызывает экспортный метод общего модуля без предварительной проверки его флагов. Сервер не обеспечивает технический read-only режим: BSL, методы общих модулей и менеджеры объектов могут создавать, изменять, записывать, проводить и помечать на удаление объекты с правами пользователя профиля. Параметр full_power возвращается в диагностике, но в production-коде не ограничивает регистрацию или выполнение tools. HTTP endpoint по умолчанию слушает loopback, однако отдельная MCP-аутентификация в коде не настроена. По умолчанию auto_register_com включен и может менять системную регистрацию V83.COMConnector. Unit-тесты из исходников были запущены, но полный прогон не состоялся: окружению не хватило зависимости pythoncom, а sandbox запретил запись во внешний системный temp; один независимый тест чтения COM registration прошел. Интеграционные проверки с реальной базой публично не поставляются и не выполнялись.