Инструменты по категориям
1c-ai config add распаковывает ZIP с XML-выгрузкой конфигурации в локальное хранилище, а 1c-ai config build строит индексы. MCP-сервер metadata читает эти индексы и исходные XML-файлы; живую базу или EDT он не опрашивает.
MCP tools по метаданным
metadata.get_metadata | получает структуру объекта по object_ref из индекса. |
|---|---|
metadata.get_dependency_graph | показывает зависимости объекта, включая направление и глубину обхода. |
metadata.get_api_reference | возвращает экспортные методы общего модуля из построенного индекса API. |
Структура формы доступна через отдельный metadata.get_form_structure и рассмотрена в категории «Формы». Сильные стороны: структурное чтение и граф зависимостей по импортированной конфигурации. Ограничения: требуется предварительная сборка индексов; нет отдельного MCP tool для изменения метаданных, ролей или поиска по свободному тексту.
1c-ai config add импортирует ZIP XML-выгрузки, 1c-ai config build готовит граф вызовов. MCP-сервер codebase читает BSL-файлы и файловый граф локальной конфигурации. Поисковые операции обращаются к отдельному хранилищу чанков, где предусмотрены BM25 и эмбеддинги; это не доступ к коду работающей базы.
MCP tools по кодовой базе
codebase.semantic_search | ищет фрагменты BSL с фильтрами конфигурации и версии; при недоступности эмбеддингов остаётся BM25. |
|---|---|
codebase.get_module | читает BSL-модуль по объекту и виду модуля, разбирает процедуры и функции. |
codebase.get_similar | ищет похожие модули по векторам. |
codebase.call_graph | выдаёт связи вызовов из построенного графа с фильтром по объекту или методу. |
Сильные стороны
доступны точное чтение модуля и граф вызовов; при отдельно заполненном хранилище — поиск. Ограничения: config build не заполняет поисковое хранилище, а публичной CLI-команды для его заполнения нет. Хранилище в памяти создаётся пустым, если DATABASE_URL не задан. get_similar в реализации с PostgreSQL не извлекает вектор найденного исходного фрагмента и может вернуть пустой результат. Нет MCP-операции записи модуля или LSP-навигации.
CLI 1c-ai hbk load --version ... --path ... извлекает методы платформы из локальной справки .hbk в SQLite. MCP-сервер kb может использовать эту базу через настройку PLATFORM_METHODS_DB; при её отсутствии обращается к резервному набору данных проекта. Онлайн-справку платформы сервер не запрашивает.
Инструменты справки по платформе
kb.check_method_availability | проверяет метод по имени, контексту выполнения и версии платформы, возвращает объяснение и найденные сведения о методе. |
|---|
Сильная сторона
проверка контекста вызова по локальной справке выбранной версии. Ограничения: нет общего поиска по всей справке, карточек типов, members/constructors и перехода к полной странице .hbk; без импортированной базы используется короткий встроенный список контекстных ограничений, который не подтверждает доступность произвольного метода.
MCP-сервер metadata читает XML-файл формы из импортированной локальной выгрузки конфигурации. metadata.get_form_structure принимает ссылку на объект, имя формы, имя и версию конфигурации и возвращает разобранную структуру управляемой формы. Он ожидает файловую раскладку XML-выгрузки Конфигуратора и не обращается к живой базе или EDT.
Инструменты по формам
metadata.get_form_structure | чтение структуры формы по объекту и имени. |
|---|
Сильная сторона
отдельная структурная операция чтения формы. Ограничения: нет поиска по всем формам, генерации, записи или проверки формы через платформу; при отсутствии ожидаемого XML-файла tool возвращает ошибку.
Сервер bsl_ls передаёт BSL-код внешнему BSL Language Server: локальному JAR через Java или настроенному HTTP-сервису. Сервер kb проверяет переданный фрагмент по локальной YAML-базе антипаттернов и стандартов. Для этих операций не требуется подключение к базе 1С.
MCP tools проверки кода
bsl_ls.lint | возвращает диагностики BSL Language Server; принимает список правил и baseline. |
|---|---|
bsl_ls.format | возвращает отформатированный BSL-код без записи исходного файла. |
kb.check_antipatterns | ищет антипаттерны в переданном коде. |
kb.check_standards | проверяет соответствие локальным правилам стандартов. |
kb.get_antipattern | объясняет выбранный антипаттерн и рекомендацию. |
Сильные стороны
отдельно доступны диагностика, форматирование и проверки по локальной базе знаний. Ограничения: без JAR или HTTP-сервиса BSL Language Server автоматически выбирается заглушка, возвращающая ноль диагностик. Проверки kb.check_antipatterns и kb.check_standards исполняют regex-правила из локального каталога; записи с AST- или BSL LS-детекторами эти два вызова сами не проверяют.
MCP-сервер kb читает шаблоны BSL-решений из локального каталога YAML-правил. Это паттерны с описанием применимости, переменными и примерами; база не связана с живой конфигурацией 1С.
MCP tools по шаблонам
kb.search_kb | ищет паттерны по текстовому запросу и категории. |
|---|---|
kb.get_pattern | возвращает паттерн по ID, в том числе текст шаблона и список переменных, если они заданы. |
Сильная сторона
агент получает структурированный пример кода и условия применения. Ограничения: MCP tools не добавляют и не изменяют шаблоны; содержимое ограничено локальной поставкой правил.
MCP-сервер kb загружает локальные YAML-правила: шаблоны решений, антипаттерны и стандарты. Поиск и проверки выполняются по этому каталогу, без обращения к ИТС или опубликованной базе 1С. Доступность методов платформы проверяется отдельно по импортированной справке .hbk либо резервным данным проекта.
MCP tools по методологии
kb.search_kb | поиск по локальной базе знаний с фильтром категории. |
|---|---|
kb.get_standard | карточка стандарта с примерами и источником. |
kb.check_standards | проверка переданного BSL-кода по правилам стандартов. |
kb.get_antipattern | описание антипаттерна и рекомендация по исправлению. |
kb.check_antipatterns | поиск антипаттернов в переданном коде. |
Сильные стороны
правила и примеры доступны локально, есть чтение и программная проверка фрагмента. Ограничения: полнота зависит от поставленного каталога правил; методическая база не обновляется автоматически из внешних источников.
Что учитывать
facade, metadata, codebase, kb, bsl_ls, git); отдельно CLI 1c-ai и HTTP API через 1c-ai serve..hbk; для проверки и форматирования BSL нужен JAR BSL Language Server или его HTTP-сервис. Генерация требует настроенную LLM; семантический поиск требует отдельно заполненное хранилище чанков и модель эмбеддингов. Git-инструментам нужны локальный репозиторий и Git, для PR также GitHub CLI.metadata и codebase читают локальные файлы и производные индексы, а не живую информационную базу. config build не наполняет поисковое хранилище для codebase.semantic_search и codebase.get_similar; готового публичного CLI для его заполнения в поставке нет. При отсутствии DATABASE_URL хранилище создаётся в памяти пустым; get_similar не получает вектор первого результата из PostgreSQL и в этом режиме может вернуть пустой список. При отсутствии BSL Language Server проверка переходит на заглушку без диагностик. Сервер facade работает с состоянием задачи и зависимостями агентного конвейера; полнота функций зависит от настройки LLM и окружения.