Мост MCP к BSL Language Server
bsl-mcp-bridge
MCP-сервер в Docker, который держит запущенным BSL Language Server и отдает агенту навигацию по коду 1С, диагностику и рефакторинг вместо grep-поиска
- 1 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Инструмент rename применяет переименование символа по всему проекту при apply=true
- code_actions может вносить автоматические исправления в файлы кода
Установка
- Работает в
- Сервисы
Ручная установка
docker compose build && docker compose up -dОдин проект получает один контейнер, каталог кода 1С задается в .env.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент rename применяет переименование символа по всему проекту при apply=true
- code_actions может вносить автоматические исправления в файлы кода
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер поднимает BSL Language Server на Java 21 внутри Docker-контейнера, держит его прогретым и следит за индексацией кодовой базы 1С. Агент получает инструменты поиска символов и текста, перехода к определению, наведения с документацией, графа вызовов, диагностики документа с синтаксическими ошибками и стилем, автоисправлений и переименования символа по всему проекту. Пути к файлам агент может передавать в любом формате: относительном, контейнерном, file-URI или хостовом Windows-пути, сервер сам нормализует их и при необходимости ищет файл по суффиксу пути.
Для кого. Для разработчиков 1С, которые хотят, чтобы агент понимал структуру кода через языковой сервер, а не угадывал ее по grep.
Подходит, если
- Нужна точная навигация по символам BSL и граф вызовов перед рефакторингом
- Нужна синтаксическая диагностика кода перед коммитом
- Нужно безопасное переименование символа во всей конфигурации
Не подходит, если
- Нет Docker или меньше 8 ГБ памяти под BSL Language Server на большом проекте
- Нужен просто быстрый текстовый поиск без индексации
Пример запроса к агенту
Найди все места, где вызывается процедура ЗаписатьВЖурнал, и покажи граф вызовов вокруг нееMCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
Переменные окружения
MCP_PROJECT_NAMEобязательная- Имя проекта, часть имени контейнера.
HOST_PROJECTS_ROOTобязательная- Путь к коду 1С на хосте.
WORKSPACE_ROOTобязательная- Корневой каталог для BSL LS внутри контейнера.
Ограничения
Нужны Docker и Docker Compose, IDE с поддержкой MCP и достаточно памяти: BSL Language Server требователен к RAM на больших проектах. На один проект приходится один контейнер, для нескольких конфигураций нужно несколько контейнеров. Проект развивает подход SteelMorgan/mcp-bsl-lsp-bridge, взятый за основу.
Как отключить. Остановите контейнер командой docker compose down и удалите сервер из конфигурации MCP-клиента.
Частые вопросы
Нужно ли вручную открывать файлы перед hover или diagnostics?
Нет, мост сам вызывает textDocument/didOpen перед такими операциями и не дублирует открытие уже отслеживаемых документов.
Что делает call_graph в отличие от call_hierarchy?
call_hierarchy показывает один уровень вызовов, а call_graph строит полный граф средствами BSL Language Server.
Обсуждение
Вопросов и отзывов пока нет.
MCP-мост к BSL Language Server: навигация, диагностика и рефакторинг кода 1С и OneScript для агентов
MCP-проверка синтаксиса BSL
1C Syntax Checker
MCP-сервер проверки синтаксиса BSL на BSL Language Server в Docker: передаете код, получаете JSON с ошибками и предупреждениями без установки Java
MCP-обертка над BSL Language Server
BSL MCP Server
Небольшой MCP-сервер, который запускает BSL Language Server как JAR-файл и отдает агенту анализ и форматирование BSL-кода в JSON
Установщик BSL Language Server
BSL Language Server installer
Скрипт ставит BSL Language Server как systemd-сервис на Linux и по флагу открывает MCP-эндпоинт для AI-агентов
1C-ai-mcp: MCP-мост к 1С:Напарнику
1C-ai-mcp
MCP-сервер, который открывает облачного ассистента 1С:Напарник (1C.ai) и локальный BSL Language Server агентам в Cursor и других IDE
MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL
Коротко о README
README описывает архитектуру из MCP-моста, менеджера LSP-сессии и BSL Language Server внутри одного Docker-контейнера, таблицы инструментов по поиску, зависимостям, диагностике и рефакторингу, форматы путей и последние изменения вроде умной нормализации URI и принудительной переиндексации после did_change_watched_files. Отдельно указано, что проект взят за основу у SteelMorgan/mcp-bsl-lsp-bridge.