Инструменты по категориям
1C Syntax MCP Server при первом запуске извлекает shcntx_ru.hbk последней найденной платформы через 7-Zip и строит локальный JSON-индекс русских и английских имен объектов, конструкторов, методов и свойств.
MCP tools по справке платформы и BSL
search_syntax | точное и подстрочное совпадение имени с ограничением числа результатов; |
|---|---|
get_function_info | сигнатура, параметры, возвращаемое значение и описание; для объекта также методы и свойства; |
suggest_completion | prefix completion по именам; |
validate_syntax | только проверка существования первого имени перед (, а не настоящий parser или validator BSL. |
Сильные стороны
минимальная инфраструктура без Elasticsearch, SQLite или embedding-сервиса; индекс автоматически строится из локальной официальной справки и работает офлайн; есть русские и английские имена.
Ограничения
поиск только по именам, без полнотекстового текста описаний, fuzzy, semantic/vector и нескольких версий. Инициализация создает большой распакованный каталог и JSON рядом с сервером. Название validate_syntax сильнее фактической проверки: аргументы и грамматика не валидируются.
Когда выбирать
когда нужен простой локальный STDIO-справочник по API установленной версии 1С без отдельной поисковой инфраструктуры.
Репозиторий включает один крупный инструкционный skill 1cskills, дополняющий syntax MCP. Его ключевое правило — перед использованием незнакомой функции или свойства сначала искать точную карточку в MCP, а не придумывать API по памяти.
Состав навыка
- контексты выполнения и клиент-серверные директивы;
- рекомендуемая структура областей разных модулей;
- ориентация в XML-выгрузке конфигурации;
- соглашения по именованию, комментариям и оформлению изменений;
- обзор БСП и типовых BSL-паттернов;
- язык запросов, HTTP-интеграции, обработка ошибок и конструкторы структур данных;
- правила по привилегированному режиму, логированию и защите секретов.
Сильные стороны
skill связывает справочные правила с конкретным локальным MCP и дает агенту широкий BSL checklist в одном файле.
Ограничения
это текстовая инструкция без собственных скриптов и автоматических проверок; значительная часть рекомендаций не подтверждается исполняемым слоем. Качество зависит от соблюдения правил агентом, а реальная справка API ограничена возможностями соседнего MCP.
Когда выбирать
когда нужен один справочный skill, направляющий агента к локальному синтакс-помощнику и одновременно задающий базовые правила BSL-разработки.
Что учитывать
mcp; установленную платформу 1С с русским файлом синтакс-помощника shcntx_ru.hbk; 7-Zip в PATH или стандартном каталоге Windows. При первом запуске сервер должен иметь право создать рядом с собой каталог распакованной справки и файл syntax_tree.json; подготовка индекса может занять 1–2 минуты и извлекает десятки тысяч файлов.shcntx_ru.hbk, разбирает HTML и string-table файлы и строит JSON-индекс объектов, конструкторов, методов и свойств с русскими и английскими именами. Поиск выполняется точным или простым подстрочным сопоставлением имен; полнотекстового, fuzzy, semantic/vector или версионного поиска нет. get_function_info возвращает сигнатуру, параметры, результат и описание, а для объектов также перечни методов и свойств. Несмотря на название, validate_syntax не парсит BSL и не проверяет сигнатуру или число аргументов: он регулярным выражением берет первое имя перед открывающей скобкой и сообщает только, найдено ли оно в индексе. Набор работает офлайн и не обращается к базе 1С. Навык 1cskills является большой текстовой инструкцией: он требует сначала обращаться к MCP за справкой и дополнительно описывает контексты BSL, структуру модулей и XML-выгрузки, БСП, язык запросов, HTTP-паттерны, обработку ошибок и правила оформления кода; собственных исполняемых скриптов у навыка нет.