1c-mcp-tools: конструктор MCP для 1С

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

1c-mcp-tools читает метаданные живой информационной базы через установленное расширение 1С. Обработки обращаются к объектам метаданных платформы в серверном контексте; HTTP JSON-RPC-интерфейс вызывает их через веб-публикацию сервиса расширения. Чтения XML/EDT/MDO-выгрузки с диска здесь нет.

Инструменты метаданных

list_metadata_objects принимает тип коллекции, необязательную подстроку имени/синонима и лимит. Возвращает текстовый список полных имён объектов с синонимами; поиск не учитывает регистр. По умолчанию до 100 результатов, без offset или курсора. Среди коллекций доступны справочники, документы, регистры, отчёты, обработки, общие модули, роли, формы и подсистемы.

get_metadata_structure получает объект по типу и точному имени и возвращает текстовое описание: стандартные и пользовательские реквизиты с типами и синонимами, табличные части, измерения и ресурсы регистров, владельцы справочника. В описании реквизита с типом-перечислением выводит первые десять значений перечисления. Набор типов для детализации ограничен прикладными объектами, регистрами, отчётами и обработками.

`list_metadata_objects`	принимает тип коллекции, необязательную подстроку имени/синонима и лимит. Возвращает текстовый список полных имён объектов с синонимами; поиск не учитывает регистр. По умолчанию до 100 результатов, без offset или курсора. Среди коллекций доступны справочники, документы, регистры, отчёты, обработки, общие модули, роли, формы и подсистемы.
`get_metadata_structure`	получает объект по типу и точному имени и возвращает текстовое описание: стандартные и пользовательские реквизиты с типами и синонимами, табличные части, измерения и ресурсы регистров, владельцы справочника. В описании реквизита с типом-перечислением выводит первые десять значений перечисления. Набор типов для детализации ограничен прикладными объектами, регистрами, отчётами и обработками.

Список форм, ролей или модулей не даёт их внутреннее устройство

отдельных операций чтения элементов форм, прав ролей и исходников BSL нет. Типы реквизитов и владельцы отражают отдельные структурные связи, но поиск использований и граф зависимостей отсутствуют. Встроенные инструменты не меняют метаданные и не выполняют запросы к данным.

Нужны платформа 1С, собранное и установленное расширение, доступ к базе и веб-публикация для встроенного HTTP-вызова. Режим совместимости расширения — 8.3.20; доступ определяется настройками публикации и правами 1С. В репозитории есть исходники; готовый CFE и внешний контур WebSocket/агрегации подключаются отдельно.

Справка платформы и BSL

1c-mcp-tools предоставляет краткую справку по синтаксису BSL как статический ресурс, хранящийся в расширении 1С. При чтении расширение возвращает весь текст встроенного справочника; установленная документация платформы и внешние сервисы справки не используются.

Ресурс и операции чтения

`1csyntax`	ресурс по URI `file://resource/syntax_1c.txt`: комментарии, типы и литералы, переменные, операторы, условия и циклы, процедуры и функции, исключения, создание объектов, препроцессор, директивы и примеры работы с коллекциями.
`resources/list`	получение имени, URI и описания ресурса.
`resources/read`	чтение справки целиком по URI через встроенный HTTP JSON-RPC-интерфейс 1С. URI обозначает ресурс расширения, а не путь к файлу на компьютере агента.

Отдельного поискового tool, карточек методов/свойств/конструкторов API, импорта HBK, выбора версии и доступа к ИТС в наборе нет. Это краткий справочник языка для передачи в контекст агента. Нужны собранное и установленное расширение, платформа 1С и для встроенного HTTP-доступа — веб-публикация базы и клиент с поддержкой MCP resources. Python-прокси и внешний транспорт в поставку не входят.

Конструкторы MCP инструментов

1c-mcp-tools размещает прикладные MCP-операции в расширении 1С. Собственная операция оформляется как BSL-обработка: она объявляет имя, описание и JSON Schema и исполняет вызов по имени. Реестр собирает обработки из соответствующих подсистем расширения и направляет запросы в их обработчики; текущие встроенные контейнеры исполняются на сервере 1С.

Публичные операции и состав

`tools/list`, `tools/call`	получение описаний инструментов и вызов контейнера с аргументами. Встроены `list_metadata_objects` и `get_metadata_structure` для чтения метаданных живой базы.
`resources/list`, `resources/read`	публикация и чтение ресурсов контейнеров. Встроен `1csyntax`, краткая справка по синтаксису BSL.
`prompts/list`, `prompts/get`	интерфейс для собственных контейнеров промптов; готовых промптов в поставке нет.
`initialize`	начальный обмен MCP через встроенный HTTP JSON-RPC-интерфейс.

Собственные инструменты, ресурсы и промпты добавляются BSL-кодом и включением обработки в нужную подсистему. Реестр кешируется на время сеанса. Визуального конструктора и загрузки произвольного BSL от агента нет; ограничения новых операций определяются их реализацией и правами 1С.

Поставка содержит XML/BSL-исходники расширения, которое нужно собрать и подключить к базе. Режим совместимости — 8.3.20. Встроенный HTTP-сервис требует веб-публикации: JSON-RPC POST обслуживает MCP-методы, GET на MCP-маршруте возвращает 405; есть отдельная проверка состояния. Запуск клиентов, WebSocket-транспорт, адаптация к внешней витрине и агрегация сессий относятся к отдельным компонентам v8-runner, web-transport-addin, wt-mcp-adapter и v8-session-manager. Готового CFE, Python-прокси, Docker-поставки и WebSocket-адаптера в этом наборе нет.

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

Подключениерасширение 1С с серверным исполнением BSL и встроенным HTTP JSON-RPC/MCP-интерфейсом при веб-публикации базы. POST принимает initialize, tools/list, tools/call, resources/list, resources/read, prompts/list и prompts/get; GET на MCP-маршруте возвращает 405, отдельный health endpoint возвращает состояние. Внешний контур WebSocket, адаптер и менеджер сессий подключаются отдельно.

Что нужноустановленную платформу 1С, сборку расширения из XML-исходников и подключение к нужной информационной базе; режим совместимости расширения — 8.3.20. Для встроенного HTTP-доступа — веб-публикацию сервиса расширения, учётную запись 1С и MCP-клиент с HTTP POST. Для добавления операций нужна разработка BSL-обработок и подключение их к соответствующим подсистемам. Для внешнего контура запуска, WebSocket и агрегации нужны отдельные v8-runner, web-transport-addin, wt-mcp-adapter и v8-session-manager.

Важнометаданные читаются средствами платформы из подключённой базы; локальные XML/MDO-выгрузки инструментами не обрабатываются. Список по умолчанию ограничен 100 объектами, постраничного продолжения нет. Встроенные tools не изменяют метаданные и данные, не выполняют запросы или произвольный BSL и не читают исходники модулей. Справка — статический текстовый ресурс, без поиска API и выбора версии платформы. Каталоги контейнеров кешируются на время сеанса; собственные операции публикуются после добавления BSL-кода и изменения состава подсистем. Поставка содержит исходники расширения; готового CFE, Python-прокси, Docker-инфраструктуры и WebSocket-адаптера нет. Доступ встроенного HTTP-сервиса определяется веб-публикацией и правами 1С.

1c-mcp-tools