BSL Atlas
MCP-сервер в Docker для поиска по выгрузке 1С: структурный индекс, граф вызовов и семантический поиск по коду
Установка
curl -O https://raw.githubusercontent.com/Arman-Kudaibergenov/bsl-atlas/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/Arman-Kudaibergenov/bsl-atlas/master/.env.example
cp .env.example .env
docker compose up -dПеред запуском укажите в .env SOURCE_PATH и INDEXING_MODE.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер индексирует XML и BSL-выгрузку конфигурации или расширения в SQLite с полнотекстовым поиском. Агент ищет процедуры по имени, получает список функций модуля и контекст вызовов, находит объекты метаданных и их структуру. В режиме fast внешние API не нужны, в режиме full добавляется векторный поиск по коду и справке через выбранного провайдера эмбеддингов. После новой выгрузки индекс обновляется запросом на переиндексацию, а к функциям без комментариев можно импортировать короткие описания, сгенерированные LLM.
Для кого. Для разработчиков 1С, которым нужен быстрый старт поиска по выгрузке через Docker без внешних ключей.
Подходит, если
- Агенту нужен поиск процедур и объектов метаданных в выгруженной конфигурации
- Нужен режим без облачных API, только структурный индекс
- Хочется искать функции по смыслу и есть провайдер эмбеддингов
Не подходит, если
- Нет Docker или нельзя смонтировать каталог с исходниками в контейнер
- Нужна работа с живой базой, а не с выгрузкой в файлы
Пример запроса к агенту
Через bsl-atlas найди процедуру ЗаполнитьТабличнуюЧасть и покажи, откуда она вызываетсяОграничения
Работает только с выгрузкой в файлы, после каждой новой выгрузки нужна переиндексация. На Windows Docker Desktop плохо переносит пути с пробелами и кириллицей, автор советует символическую ссылку. Режим full требует ключа провайдера эмбеддингов, например OpenRouter, или локальной Ollama. Лицензия репозитория AGPL-3.0.
Как отключить. Удалите блок bsl-atlas из .mcp.json или claude_desktop_config.json и остановите контейнер командой docker compose down.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| SOURCE_PATH обязательная | Каталог с выгрузкой конфигурации на хосте |
| INDEXING_MODE обязательная | Режим индексации: fast или full |
Проверка безопасности
- Запускает контейнер и читает все файлы выгрузки
- В режиме full отправляет фрагменты кода провайдеру эмбеддингов
Коротко о README
README ведет по шагам: выгрузить конфигурацию в файлы, скачать docker-compose.yml и .env.example, указать путь к исходникам и режим, запустить контейнер и подключить MCP по HTTP. Отдельно разобраны проблемы монтирования на Windows и поддерживаемые структуры каталогов. Перечислены инструменты поиска, рекомендованные модели эмбеддингов и способ добавить описания функций, сгенерированные LLM.
Частые вопросы
Чем режим fast отличается от full?
Fast дает структурный поиск без внешних API. Full добавляет семантический поиск по коду и справке и требует провайдера эмбеддингов.
Атлас пишет, что каталог исходников пустой. Что делать?
Почти всегда это неверный bind mount: проверьте SOURCE_PATH и на Windows замените путь с кириллицей символической ссылкой.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything