BSL CallGraph MCP Server

Установка

Ручная установка

git clone https://github.com/ShustovM/bsl-callgraph.git
cd bsl-callgraph
npm ci
npm test

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер индексирует .bsl файлы в памяти и дает MCP-клиенту семь инструментов: find_symbol и search_symbols для поиска определений по точному имени или подстроке, get_callers и get_callees для поиска вызывающих и вызываемых процедур, get_impact для транзитивного обхода зоны влияния изменения, reindex для пересборки индекса после изменения файлов и stats со server_info для состояния и возможностей сервера. Каждый вызов классифицируется как resolved (цель однозначно известна), ambiguous (несколько кандидатов) или dynamic (нужен рантайм-тип), и режим exact отдает только разрешенные ребра, а exploratory показывает неоднозначные кандидаты с указанием уверенности. Стейтфул-лексер распознает русские и английские объявления Процедура/Функция, Асинх и Экспорт, включая многострочные сигнатуры, и не превращает текст запросов внутри строк в ребра графа. Анализ статический и намеренно легковесный: не компилятор BSL и не полный вывод типов, результаты годятся как навигационная подсказка, а не доказательство.

Для кого. Для 1С-разработчиков, которым нужно быстро оценить зону влияния изменения в большой конфигурации без ручного обхода файлов.

Пример запроса к агенту

Найди всех, кто вызывает функцию РассчитатьСумму, и оцени зону влияния ее изменения на глубину 3

Ограничения

Динамическая диспетчеризация и значения в переменных не всегда разрешаются в единственную цель, одинаковые имена символов или модулей могут быть неоднозначны, препроцессор, вывод типов и метаданные рантайма не учитываются. Корень с BSL-файлами задается один раз при запуске клиентом и не может быть заменен вызовом инструмента. Результаты не гарантируют фиксированную задержку или точный процент экономии токенов.

Как отключить. Удалите регистрацию сервера из MCP-клиента, например codex mcp remove bsl-callgraph, и остановите процесс сервера, кеша на диске сервер не создает.

MCP

Транспорт

stdio

Авторизация

не нужна

Проверка безопасности

• Инструменты строго read-only, сервер не выполняет BSL-код и не требует сети
• Ответы содержат имена символов, модулей и относительные пути файлов, которые видит подключенный клиент

Коротко о README

README подробно описывает семь инструментов с параметрами, классификацию ребер графа на resolved/ambiguous/dynamic, границы точности статического анализа и раздел приватности: парсинг идет локально, сервер не выполняет BSL-код и не требует сети, но ответы MCP видит подключенный клиент и, возможно, удаленный агент по его политике. Даны команды установки из исходников, конфигурация для Codex CLI, Claude Code и универсального stdio-клиента с примерами для POSIX и Windows, раздел устранения неполадок и деинсталляции. Есть baseline и benchmark скрипты для измерения производительности на своей машине. Лицензия MIT.

Похожие