BSL Code Search MCP
Локальный read-only MCP-сервер поиска по коду 1С на движке Zoekt: быстрый лексический и regex-поиск по своим выгрузкам конфигураций
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты строго read-only, изменить код или базу невозможно
- Индекс хранит текст исходников локально и должен защищаться как сама выгрузка
Установка
Ручная установка
.\bsl-code-search-mcp.exe index --name "my-configuration" --source "C:\path\to\configuration\sources" --defaultИндексирует выгрузку конфигурации и делает ее основной для запросов без явного corpus.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент индексирует выгрузку конфигурации 1С в файлы (из Конфигуратора или EDT) движком Zoekt и отдает агенту два строго read-only инструмента: search_code для лексического, точного или regex-поиска по коду с контекстом строк и list_corpora для списка подключенных корпусов и их статистики. Можно проиндексировать несколько конфигураций под разными именами, задать одну как основную для запросов без явного указания корпуса и искать по всем сразу флагом allCorpora. Индексация читает только явно указанный исходный каталог и пишет только локальный индекс, сам сервер не делает сетевых обращений и не хранит и не возвращает пути к исходникам в ответах инструментов.
Для кого. Для 1С-разработчиков, которым нужен быстрый поиск по большим выгрузкам конфигураций прямо из агента, без отправки кода куда-либо за пределы своей машины.
Подходит, если
- Нужен быстрый поиск примеров использования метода или паттерна по всей выгрузке конфигурации
- Работа ведется с несколькими конфигурациями сразу и нужно искать то в одной, то во всех
- Важно, чтобы код конфигурации не покидал компьютер и не уходил в сеть
Не подходит, если
- Нужна не только текстовая, а семантическая навигация: определения, вызовы, граф вызовов, для этого нужен другой инструмент
- Платформа отличается от Windows x64: остальные ОС официально не протестированы
Пример запроса к агенту
Найди все места в конфигурации, где вызывается ИзменитьРеквизиты, и покажи контекстОграничения
Репозиторий не содержит никаких конфигураций 1С, включая ERP и ЗУП, индексировать нужно свою выгрузку. Официально протестирована только сборка под Windows x64. Индекс может быть большим, примерно вдвое больше объема исходного BSL-текста, и должен храниться так же аккуратно, как сама выгрузка конфигурации.
Как отключить. Удалите запись bsl-code-search-mcp из конфигурации MCP клиента, при необходимости сотрите локальный каталог индекса.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| BSL_CODE_SEARCH_INDEX | Путь к каталогу индекса, если используется нестандартное расположение. |
Проверка безопасности
- Инструменты строго read-only, изменить код или базу невозможно
- Индекс хранит текст исходников локально и должен защищаться как сама выгрузка
Коротко о README
README подробно описывает три шага: выбор и индексацию исходной выгрузки, проверку подключенных конфигураций командой status и подключение MCP-клиента командой serve. Даны примеры запросов search_code с фильтрами по файлу, регистру и regex, объяснена приоритетность выбора корпуса для разных типов задач. Отдельный раздел про приватность подчеркивает, что индексация не пишет ничего за пределы локального индекса, а серверные инструменты read-only с аннотациями readOnlyHint и idempotentHint. Даны команды сборки из исходников и упомянуты закрепленные версии зависимостей.
Частые вопросы
Уходит ли код конфигурации в сеть?
Нет, индексация читает только указанный каталог, сервер serve не делает внешних сетевых вызовов, а его бэкенд слушает случайный localhost-порт.
Можно ли искать сразу по нескольким конфигурациям?
Да, каждая конфигурация индексируется под своим именем, а поиск с allCorpora: true идет по всем подключенным сразу.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything