BSL Search MCP
Read-only MCP-сервис гибридного поиска по коду 1С BSL: BM25 плюс векторный поиск, дедупликация и reranking
- 3 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Поднимает через Docker Compose Elasticsearch, сервис эмбеддингов, reranker и MCP-сервер
- Инструменты только ищут по корпусу кода 1С и ничего в нем не меняют
Установка
- Работает в
- Сервисы
Ручная установка
cp .env.example .env
docker compose up -d --buildВ .env нужно указать адреса Elasticsearch, embedding и reranker сервисов и при необходимости MCP_AUTH_TOKEN.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Поднимает через Docker Compose Elasticsearch, сервис эмбеддингов, reranker и MCP-сервер
- Инструменты только ищут по корпусу кода 1С и ничего в нем не меняют
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервис дает LLM поиск по большому корпусу реального кода 1С: процедурам и функциям конфигураций и БСП, а также документации ИТС и статьям с Habr. Поиск гибридный, BM25 и векторный kNN объединяются через Reciprocal Rank Fusion, near-duplicate методы отсеиваются через SimHash, а итоговый порядок результатов задает внешний reranker. Три MCP-инструмента с подробными описаниями под маленькие модели позволяют искать по смыслу с фильтрами по БСП, репозиторию, типу модуля и директиве, получать полный текст метода по ID и искать по точной сигнатуре. Архитектура состоит из mcp-server, search-api, Elasticsearch, сервиса embeddings и reranker, поднимается через Docker Compose.
Для кого. Для 1С-разработчиков и команд, которые обучают или подключают агента к контексту большой кодовой базы BSL.
Подходит, если
- Нужен поиск по коду 1С и БСП по смыслу запроса, а не по точному тексту
- Нужен контекст реального кода для маленьких моделей с подробными описаниями инструментов
- Важно, чтобы сервис был строго read-only и не мог изменить индекс или код
Не подходит, если
- Нет ресурсов держать Elasticsearch, сервис embeddings и reranker в инфраструктуре
- Нужен поиск только по вашей маленькой конфигурации без корпуса БСП и документации
- Нужна запись или анализ качества кода, а не только поиск
Пример запроса к агенту
Найди в коде 1С похожие методы обработки проведения документа с отбором по БСПMCP
- Транспорт
- http
- Авторизация
- ключ необязателен
Переменные окружения
ELASTICSEARCH_URLобязательная- Адрес Elasticsearch с индексами методов и знаний
EMBEDDING_URLобязательная- Адрес сервиса embeddings
RERANKER_URLобязательная- Адрес сервиса reranker
MCP_AUTH_TOKENсекрет- Токен аутентификации MCP-сервера
Ограничения
Разворачивается через Docker Compose с несколькими сервисами: Elasticsearch, embedding и reranker. Корпус собран автором из открытого кода и общедоступных источников, состав и полнота зависят от версии сборки. Лицензия в репозитории не указана. Проект активно меняется, часть документов README в статусе рабочих заметок.
Как отключить. Остановите стек командой docker compose down и удалите сервер из настроек MCP-клиента.
Частые вопросы
Сервис может изменить код или индекс?
Нет, все три инструмента помечены readOnly, сервис только читает и ищет.
Что покрывает корпус?
По README это 380 416 дедуплицированных методов кода из более 451 тысячи исходных, плюс документы ИТС и статьи Habr.
Обсуждение
Вопросов и отзывов пока нет.
Локальный read-only MCP-сервер поиска по коду 1С на движке Zoekt: быстрый лексический и regex-поиск по своим выгрузкам конфигураций
Семантический поиск по справке 1С
1c-sntx-sem
MCP-сервер для Cursor и Claude Desktop с гибридным поиском embeddings и BM25 по справке платформы 1С, языку запросов и Библиотеке стандартных подсистем
MCP-сервер в Docker для поиска по выгрузке 1С: структурный индекс, граф вызовов и семантический поиск по коду
MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor
Семантический поиск по коду 1С
1C Code Search MCP
Локальный MCP-сервер для семантического поиска по выгруженной конфигурации 1С с выбором модели эмбеддингов и векторной БД
MCP гибридного поиска по синтакс-помощнику 1С
BSL syntax-help MCP
Docker-сервисы с гибридным поиском (FTS5 плюс эмбеддинги) по синтакс-помощнику платформы 1С, выгружаемому из 1C:EDT плагином на Tycho
Коротко о README
Двуязычный README на русском и английском описывает архитектуру из mcp-server, search-api, Elasticsearch, embedding и reranker сервисов. Даны таблица переменных окружения, команды запуска через Docker Compose и без него, описание трех MCP-инструментов и отдельный раздел про загрузчик датасета с дедупликацией через SimHash и построением embeddings пакетами. В структуре проекта отдельно вынесены benchmark и tests.