MCP-проверка синтаксиса BSL
1C Syntax Checker
MCP-сервер проверки синтаксиса BSL на BSL Language Server в Docker: передаете код, получаете JSON с ошибками и предупреждениями без установки Java
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только анализирует переданный код и возвращает диагностику, не пишет в файлы проекта
Установка
Ручная установка
./scripts/install.sh && ./scripts/start.shСкачивает JAR BSL Language Server и собирает Docker-образ, затем запускает сервер на порту 8010.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер запускает BSL Language Server 0.29.0 на Temurin 21 внутри Docker-образа и дает агенту три инструмента: syntaxcheck для отдельного фрагмента кода, syntaxcheck_file для одного файла с указанием пути, чтобы верно применялись правила именования по типу модуля, и syntaxcheck_project для нескольких файлов сразу с межмодульной диагностикой. Параметр min_severity фильтрует уровень серьезности от HINT до ERROR, а ответ содержит счетчики по уровням, список диагностик с указанием файла и человекочитаемое summary_text. Java на компьютере агента не нужна: весь анализ идет внутри контейнера.
Для кого. Для разработчиков 1С в Cursor, которым нужна быстрая проверка синтаксиса BSL без установки Java и без выхода из редактора.
Подходит, если
- Нужно проверить сгенерированный агентом BSL-код на ошибки перед вставкой
- Нужна межмодульная диагностика по нескольким файлам сразу
- Нет желания ставить Java и BSL Language Server локально
Не подходит, если
- Нет Docker Desktop или Docker Engine на машине
- Нужны навигация по коду и рефакторинг, а не только проверка синтаксиса
Пример запроса к агенту
Проверь этот модуль на ошибки уровня WARNING и выше и покажи только предупрежденияОграничения
Нужны Docker и около 2 ГБ места под образ и JAR BSL Language Server. Версия сервера жестко привязана к bsl.version, обновление требует пересборки образа. Еженедельный GitHub Actions только заводит issue о новой версии BSL LS, автообновления нет.
Как отключить. Останови контейнер скриптом stop.sh или stop.ps1 и удали сервер из .cursor/mcp.json.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| SYNTAXCHECK_PORT | Порт на хосте, по умолчанию 8010. |
| BSL_VERSION | Версия BSL Language Server, по умолчанию 0.29.0. |
Проверка безопасности
- Только анализирует переданный код и возвращает диагностику, не пишет в файлы проекта
Коротко о README
README описывает три MCP-инструмента с таблицей параметров и уровней серьезности, установку через install.ps1 или install.sh, Python CLI с командами install, start, stop, set-port, mcp-snippet, test и update-bsl, смену порта и еженедельный workflow, который заводит issue при выходе новой версии BSL Language Server.
Частые вопросы
Нужна ли Java на моей машине?
Нет, Temurin 21 и BSL Language Server работают только внутри Docker-контейнера.
Как обновить версию BSL Language Server?
Командой python -m syntaxcheck_mcp.cli update-bsl, значение синхронизируется в bsl.version и .env, затем нужно пересобрать образ.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything