BSL Platform Context MCP
Локальный read-only MCP-сервер справки платформы 1С:Предприятие: точные карточки типов, методов и конструкторов из установленных HBK-файлов
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Java-сервер, который разбирает файлы синтакс-помощника установленной платформы 1С
- В сеть не ходит и к информационной базе не подключается
iiityraeliii/bsl-platform-context-mcp
Похожий инструмент с большим сообществом: Справка платформы 1С по MCP, 207 ★ репозитория
Установка
- Работает в
- Сервисы
Ручная установка
$env:JAVA_HOME = "path\to\jdk-21"
.\gradlew.bat clean test portableZipСборка портативного архива с приватным jlink-рантаймом и fat-jar.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Java-сервер, который разбирает файлы синтакс-помощника установленной платформы 1С
- В сеть не ходит и к информационной базе не подключается
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер один раз при старте разбирает файлы синтакс-помощника установленной платформы 1С, shcntx_*.hbk и shlang_*.hbk, и строит неизменяемую модель API платформы, отдавая ее агенту через шесть read-only инструментов: поиск с ранжированием и пагинацией, точная карточка типа или перечисления, точный метод, свойство, событие или конструктор, отфильтрованный список членов типа, все документированные перегрузки конструкторов и информация о версии платформы. В отличие от промежуточных моделей, сервер сохраняет все детали справки: обе языковые версии имен, сырой синтаксис, обязательные, по умолчанию и вариативные параметры, версии появления и устаревания, примечания, примеры и связанные элементы. Разбор основан на закрепленной версии парсера 1c-syntax/bsl-context без потери информации при маппинге, а транспорт на официальном Java MCP SDK.
Для кого. Для 1С-разработчиков, которым нужна точная справка по методам и конструкторам платформы прямо в агенте вместо ручного поиска в синтакс-помощнике.
Подходит, если
- Нужна точная сигнатура метода или все перегрузки конструктора платформенного типа
- Нужно проверить, с какой версии платформы доступен метод или когда он устарел
- Нужен поиск по справке платформы без открытия синтакс-помощника
Не подходит, если
- Нет локальной установки 1С:Предприятие с русской справкой на Windows x64
- Нужна справка по коду собственной конфигурации, а не по платформе: это другой инструмент
Пример запроса к агенту
Покажи все перегрузки конструктора ОписаниеТипов и с какой версии платформы они доступныMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
BSL_PLATFORM_PATH- Явный путь к установке платформы 1С или ее HBK-файлам.
BSL_PLATFORM_VERSION- Выбор конкретной установленной версии платформы без указания машинного пути.
Ограничения
Работает только на Windows x64 с локальной установкой 1С:Предприятие, содержащей русскую справку shcntx_ru.hbk. Сборка требует JDK 21, готового кроссплатформенного бинарника нет. Сервер не обращается к сети и не подключается к информационной базе, это чисто справочный инструмент по платформе.
Как отключить. Удалите запись сервера из конфигурации MCP клиента.
Частые вопросы
Можно ли выбрать конкретную версию платформы?
Да, через параметр -PlatformPath, переменную окружения BSL_PLATFORM_PATH или BSL_PLATFORM_VERSION для выбора версии без указания машинного пути.
Теряются ли детали справки при разборе?
Нет, сервер читает объекты API напрямую из пропатченного парсера без промежуточного маппинга с потерями, поэтому сохраняются оба языковых варианта имен, примеры и связанные элементы.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер со справочником платформы 1С и проверкой BSL-кода на соответствие реальному API нужной версии платформы
MCP-сервер по документации API платформы 1С прямо из файлов справки shcntx_ru.hbk, с keyword, semantic и hybrid поиском
Справка платформы 1С по MCP
mcp-bsl-platform-context
MCP-сервер со справкой синтакс-помощника 1С: поиск функций, типов, методов, свойств и конструкторов из установленной платформы
Экспортер контекста платформы 1С
platform-context-exporter
Консольное приложение на Java, которое выгружает справку платформы 1С:Предприятие в JSON, XML, Markdown или формат context для LLM
MCP-сервер для поиска и проверки синтаксиса 1С, который сам распаковывает справку из установленной платформы при первом запуске
MCP-сервер поиска по синтакс-помощнику платформы 1С: глобальные функции, методы и свойства объектов через Elasticsearch
Коротко о 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С никогда не распространяется вместе с проектом.