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

1C HBK BSL разбирает локальную XML-выгрузку конфигурации и строит индекс метаданных. Для предметных MCP tools в workspace нужна Configuration.xml; они не обращаются к работающей информационной базе.

MCP tools по метаданным конфигурации

bsl_meta_collectionсписок объектов выбранной глобальной коллекции;
bsl_meta_objectреквизиты, табличные части и атрибуты форм одного объекта;
bsl_meta_indexповторный разбор XML и перестроение индекса после изменений.

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

просмотр основных сведений об объекте рядом с BSL-навигацией и диагностикой в одном наборе. Ограничения: отдельного полного дерева форм, списка прав ролей, графа связей и операций изменения метаданных нет. Надстройка BSL MCP Analyzer использует эти же три базовых tools.

1C HBK BSL индексирует BSL/OS-файлы локального workspace в SQLite. После открытия пустого индекса MCP запускает фоновое заполнение; после изменения отдельного файла агент обновляет индекс через bsl_index_file. Кроме MCP-сервера проект предоставляет LSP и расширение VS Code/Cursor с навигацией по исходникам.

MCP tools по кодовой базе

bsl_status, bsl_index_fileсостояние и обновление индекса;
bsl_find_symbol, bsl_file_symbols, bsl_definitionпоиск символов, структура файла и переход к определению;
bsl_callers, bsl_callees, bsl_referencesсвязи вызовов и использования;
bsl_read_file, bsl_search, bsl_workspace_scanчтение, текстовый поиск и обзор файлов;
bsl_hoverсигнатура и документация символа проекта, с резервным поиском во встроенном API платформы;
bsl_renameплан переименования с записью только при apply=true.

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

одни и те же локальные исходники доступны для MCP-навигации, LSP и CLI-проверок. Ограничения: индекс отражает файловую копию проекта, а не код работающей базы; это не семантический векторный поиск.

1C HBK BSL предоставляет точечную справку как часть локального анализатора BSL. MCP tool bsl_hover сначала ищет символ в индексе текущего проекта, затем глобальную функцию или тип во встроенных данных API платформы. Для функции он возвращает сигнатуру, описание и тип результата; для типа — описание и имена первых методов. LSP расширения дополнительно использует те же данные для hover и completion в редакторе.

MCP tools по справке платформы и BSL

bsl_hoverкарточка символа по точному имени с резервным поиском во встроенном API платформы.

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

справка доступна в том же процессе, что диагностика и навигация по проекту. Ограничения: это не поиск по полному .hbk, нет отдельного списка версий или MCP tools для полного перечня методов, свойств и конструкторов типа.

1C HBK BSL анализирует локальные BSL/OS-файлы собственным Python-движком с tree-sitter. CLI onec-hbk-bsl check проверяет проект, каталог или файл и выводит text, JSON либо SARIF; расширение VS Code/Cursor и LSP показывают диагностики в редакторе. MCP работает локально через stdio или Streamable HTTP.

MCP tools по проверке кода

bsl_diagnostics, bsl_check_fileдиагностики выбранного файла;
bsl_list_rulesдоступные правила;
bsl_format, bsl_fixформатирование и автоматические исправления с записью только при write=true;
bsl_renameплан переименования и транзакционное применение при apply=true.

CLI дополнительно поддерживает фильтры правил, подавляющие комментарии, baseline и проверку изменений относительно Git. Сильные стороны: единый движок для CLI, LSP, MCP и расширения; машинные отчёты для CI. Ограничения: проверяет файловый проект и не обращается к живой базе. Отдельного MCP tool для агрегированного отчёта всего проекта в базовом наборе нет; такую операцию добавляет надстройка BSL MCP Analyzer.

1C HBK BSL подключается к VS Code/Cursor как расширение со встроенным сервером; тот же движок можно запустить отдельным LSP, CLI или локальным MCP. Контекст — открытый каталог исходников 1С, не живая сессия EDT или Конфигуратора.

Операции среды разработки

  • LSP: диагностики, hover, completion, навигация по определениям и использованиям, форматирование, переименование и подсказки;
  • MCP: bsl_status, bsl_find_symbol, bsl_definition, bsl_hover, bsl_references, bsl_diagnostics, bsl_format, bsl_rename, bsl_fix дают агенту аналогичные файловые операции;
  • CLI: check, format, index для ручной проверки и CI.

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

расширение поставляет готовый сервер без необходимости устанавливать системный Python. Ограничения: нет доступа к текущей сессии платформы, живым данным или runtime-отладке; все операции основаны на файловом workspace.

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

Подключениелокальный MCP через onec-hbk-bsl mcp --stdio --workspace <проект> либо Streamable HTTP на порту 8051 по умолчанию; LSP через stdio, CLI onec-hbk-bsl, расширение VS Code/Cursor и Python API.
Что нужнодля PyPI-пакета Python 3.12+; MCP-зависимость входит в полный пакет onec-hbk-bsl либо устанавливается как extra для onec-hbk-bsl-core. Для анализа нужен локальный каталог BSL/OS-исходников; для MCP tools метаданных — XML-выгрузка конфигурации. Платформенные VSIX включают сервер и не требуют системного Python.
Важнопроект использует собственный Python-анализатор и tree-sitter, не запускает Java BSL Language Server. Символы и вызовы индексируются в SQLite; MCP при пустом индексе запускает фоновое заполнение, а после правки отдельного файла требуется переиндексация. bsl_hover сначала ищет символ в проекте, затем в поставляемых данных API платформы; это точечная справка, не полнотекстовый поиск по .hbk. bsl_format и bsl_fix записывают файл только с write=true, bsl_rename применяет план с apply=true; по умолчанию возвращают результат без записи. MCP ограничивает доступ стартовым workspace. Из этого проекта BSL MCP Analyzer использует 22 базовых tools и добавляет три собственных.