BSL Platform Context MCP
Локальный read-only MCP-сервер справки платформы 1С:Предприятие: точные карточки типов, методов и конструкторов из установленных HBK-файлов
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты строго read-only и работают только со справкой платформы
- Сервер не обращается к сети и не подключается к информационной базе
Установка
Ручная установка
$env:JAVA_HOME = "path\to\jdk-21"
.\gradlew.bat clean test portableZipСборка портативного архива с приватным jlink-рантаймом и fat-jar.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер один раз при старте разбирает файлы синтакс-помощника установленной платформы 1С, shcntx_*.hbk и shlang_*.hbk, и строит неизменяемую модель API платформы, отдавая ее агенту через шесть read-only инструментов: поиск с ранжированием и пагинацией, точная карточка типа или перечисления, точный метод, свойство, событие или конструктор, отфильтрованный список членов типа, все документированные перегрузки конструкторов и информация о версии платформы. В отличие от промежуточных моделей, сервер сохраняет все детали справки: обе языковые версии имен, сырой синтаксис, обязательные, по умолчанию и вариативные параметры, версии появления и устаревания, примечания, примеры и связанные элементы. Разбор основан на закрепленной версии парсера 1c-syntax/bsl-context без потери информации при маппинге, а транспорт на официальном Java MCP SDK.
Для кого. Для 1С-разработчиков, которым нужна точная справка по методам и конструкторам платформы прямо в агенте вместо ручного поиска в синтакс-помощнике.
Подходит, если
- Нужна точная сигнатура метода или все перегрузки конструктора платформенного типа
- Нужно проверить, с какой версии платформы доступен метод или когда он устарел
- Нужен поиск по справке платформы без открытия синтакс-помощника
Не подходит, если
- Нет локальной установки 1С:Предприятие с русской справкой на Windows x64
- Нужна справка по коду собственной конфигурации, а не по платформе: это другой инструмент
Пример запроса к агенту
Покажи все перегрузки конструктора ОписаниеТипов и с какой версии платформы они доступныОграничения
Работает только на Windows x64 с локальной установкой 1С:Предприятие, содержащей русскую справку shcntx_ru.hbk. Сборка требует JDK 21, готового кроссплатформенного бинарника нет. Сервер не обращается к сети и не подключается к информационной базе, это чисто справочный инструмент по платформе.
Как отключить. Удалите запись сервера из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| BSL_PLATFORM_PATH | Явный путь к установке платформы 1С или ее HBK-файлам. |
| BSL_PLATFORM_VERSION | Выбор конкретной установленной версии платформы без указания машинного пути. |
Проверка безопасности
- Инструменты строго read-only и работают только со справкой платформы
- Сервер не обращается к сети и не подключается к информационной базе
Коротко о README
README описывает сервер как локальный read-only STDIO MCP для справки платформы, перечисляет шесть инструментов со стабильными кодами ошибок NOT_FOUND, AMBIGUOUS, INVALID_ARGUMENT и PLATFORM_HELP_UNAVAILABLE. Даны требования (Windows x64, JDK 21, русская справка), команды сборки portableZip с детерминированным архивом, запуск через run.ps1 с вариантами выбора платформы и раздел верификации с реальными HBK-тестами по конкретным типам платформы. Раздел происхождения называет закрепленные версии парсера bsl-context и Java MCP SDK и подчеркивает, что справка 1С никогда не распространяется вместе с проектом.
Частые вопросы
Можно ли выбрать конкретную версию платформы?
Да, через параметр -PlatformPath, переменную окружения BSL_PLATFORM_PATH или BSL_PLATFORM_VERSION для выбора версии без указания машинного пути.
Теряются ли детали справки при разборе?
Нет, сервер читает объекты API напрямую из пропатченного парсера без промежуточного маппинга с потерями, поэтому сохраняются оба языковых варианта имен, примеры и связанные элементы.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything