MCP-сервер графа конфигурации 1С

Установка

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

git clone --recurse-submodules https://github.com/axel-avb/mcp-1c-metadata.git
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

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

Что делает

Сервер разбирает стандартную выгрузку конфигурации 1С в исходный код: XML-метаданные объектов и BSL-модули, строит SQLite-граф со связями объект-элемент, модуль-символ, вызовы и ссылки между объектами. Двадцать три инструмента дают инвентарь конфигурации, структуру объекта по секциям, поиск объектов и элементов по описанию, граф вызовов процедур с BFS на заданную глубину и тело рутины с пагинацией. Семантический поиск search_config и search_bsl_code опциональны: без внешнего OpenAI-совместимого эмбеддера и Qdrant все структурные инструменты работают на голом SQLite-графе, реранкер тоже опционален и деградирует до порядка ANN-поиска. Отдельно поддержаны легаси-формы обычного типа: BSL из Form.bin извлекается вендоренным бинарным парсером.

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

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

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

Ограничения

BSL-парсер строковый и не грамматический, достаточен для графа вызовов и поиска, но не для строгой валидации кода. Директивы условной компиляции #Если/#Иначе не раскрываются, что может дать дубль в счетчике символов. Вызовы разрешаются по имени в глобальном пространстве 1С, поэтому у одноименных процедур в разных модулях ребра CALLS ведут на всех кандидатов. Семантический поиск требует внешний OpenAI-совместимый эмбеддер и Qdrant, без них работает только структурная часть. Размерность вектора эмбеддера должна точно совпадать с настройкой, иначе Qdrant отклонит запись. Требует Python 3.11 и выше.

Как отключить. Остановите процесс python -m src.server и удалите сервер из конфигурации MCP-клиента.

MCP

Транспорт

http

Авторизация

API-ключ

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

• При включенном семантическом поиске код и метаданные конфигурации отправляются во внешний эмбеддер и реранкер
• HTTP-эндпоинт по умолчанию слушает 0.0.0.0 и без auth_token открыт без аутентификации

Коротко о README

README описывает возможности парсера XML и BSL, SQLite-граф, опциональный семантический поиск через эмбеддер, Qdrant и реранкер с таблицей деградации при отсутствии каждого компонента, установку с сабмодулями, приоритет конфигурации из переменных окружения, ожидаемый формат выгрузки конфигурации, команды индексации с разными флагами, полный список из двадцати трех инструментов по группам, расход токенов на инициализацию схемы инструментов, подключение к Claude Desktop и Claude Code, запуск через Docker Compose и подробный раздел ограничений включая нераскрытие условной компиляции и требования к RAM для больших конфигураций.

Похожие