Graph Metadata Search - это MCP сервер 1С, который строит граф связей метаданных конфигурации на базе Neo4j. В отличие от обычного поиска, ИИ не просто находит объекты по названию - он понимает, как они связаны: какой документ использует какой справочник, какие регистры затрагивает проведение, какие общие модули вызываются из форм.

Конфигурация 1С - это не просто набор объектов. Это сложная сеть взаимосвязей: справочники подчиняются владельцам, документы ссылаются на справочники и регистры, общие модули вызываются из десятков форм, проводки затрагивают регистры, отчёты строятся на движениях документов. В типовой конфигурации такие связи образуют граф из тысяч узлов и десятков тысяч рёбер. Ориентироваться в них вручную - задача, граничащая с невозможностью. Graph Metadata Search решает эту проблему кардинально: он загружает всю структуру конфигурации в Neo4j и предоставляет ИИ четыре мощных инструмента для навигации по этому графу.

Что это и зачем

Graph Metadata Search - это MCP-сервер (Model Context Protocol), который запускается в Docker-контейнере вместе с графовой базой данных Neo4j. На вход сервер принимает XML-отчёт по метаданным из Конфигуратора 1С, после чего строит полноценный граф связей:

  • Объекты метаданных - справочники, документы, регистры, отчёты, обработки, ПВХ, константы и другие узлы графа.
  • Связи между объектами - реквизиты ссылочного типа, подчинённые объекты, регистрация в регистрах, общие реквизиты, связи подчинённости.
  • Вызовы кода - какие функции и процедуры вызываются из каких модулей, формируя направленный граф вызовов.

Сервер предоставляет 4 ключевых инструмента, каждый из которых решает свою задачу:

  • search_metadata - графовый поиск метаданных с поддержкой Cypher-запросов и JSON-фильтрации. Можно задавать вопросы вроде «найди все документы, которые используют справочник Контрагенты через реквизиты ссылочного типа».
  • trace_impact - анализ влияния изменений. Показывает, какие объекты будут затронуты, если изменить выбранный элемент. Критически важно для безопасного рефакторинга.
  • trace_call_chain - навигация по графу вызовов. Строит цепочки вызовов функций и процедур, показывая полный путь от точки входа до конечного модуля.
  • dossier - полное досье на объект метаданных. Собирает всю известную информацию о выбранном объекте: его реквизиты, связи, места вызова, типы, подчинённые объекты.

🧠 Ключевая идея

Обычный поиск по метаданным работает как «плоская» таблица: вы ищете объект по имени и получаете его атрибуты. Графовый подход работает иначе: каждый объект - это узел, а связи между объектами - рёбра. ИИ может «путешествовать» по этому графу: от справочника к документу, от документа к регистру, от регистра к отчёту. Это даёт понимание архитектуры конфигурации, а не просто список объектов.

Как работает Graph Metadata Search

Архитектура сервера построена на стеке Neo4j + MCP-протокол:

  1. Загрузка метаданных: XML-отчёт из Конфигуратора парсится, извлекаются все объекты, их реквизиты, типы, связи. Каждый объект становится узлом Neo4j, каждая связь - ребром с типом (использует, подчиняется, ссылается, вызывает и т.д.).
  2. Построение графа вызовов: BSL-код модулей анализируется на предмет вызовов функций и процедур. Для каждой функции строится направленное ребро к вызываемым функциям. Получается полноценный граф вызовов.
  3. Cypher-запросы: Инструмент search_metadata поддерживает прямые Cypher-запросы к Neo4j для сложных сценариев поиска. А также упрощённые JSON-запросы для типовых случаев.
  4. Анализ влияния: trace_impact использует алгоритмы поиска путей в графе, чтобы определить все узлы, достижимые из заданного. Показывает не только прямые, но и транзитивные зависимости.

4 инструмента - навигация по графу конфигурации

🔍 search_metadata - графовый поиск

Позволяет ИИ задавать сложные вопросы о связях в конфигурации. Поддерживает два режима: Cypher-запросы для точного контроля и JSON-запросы для быстрого поиска по типовым условиям. Пример: «Найди все справочники, на которые ссылается документ РеализацияТоваровУслуг, и покажи через какие реквизиты».

⚠️ trace_impact - анализ влияния изменений

Перед тем как изменить объект, нужно понять, что сломается. trace_impact строит полное дерево зависимостей: какие объекты ссылаются на изменяемый, какие модули его вызывают, какие отчёты используют его данные. Это позволяет оценить объём регрессионного тестирования и избежать неожиданных поломок при доработках.

🔄 trace_call_chain - навигация по графу вызовов

Строит цепочки вызовов от любой точки входа. Например, при проведении документа: форма → модуль объекта → общий модуль → модуль регистра. Позволяет понять весь путь выполнения операции, что критично для отладки и оптимизации.

📋 dossier - полное досье на объект

Собирает всю информацию об объекте в одном месте: реквизиты, табличные части, предопределённые элементы, типы данных, все ссылающиеся объекты, все вызываемые функции, все места вызова объекта. Это «паспорт» объекта метаданных, который даёт ИИ полное понимание его роли в конфигурации.

Какие боли решает

Graph Metadata Search решает проблемы, которые не видны при работе с «плоским» поиском метаданных:

  • «Я изменил справочник - что сломается?» - классическая проблема доработок 1С. trace_impact мгновенно показывает все объекты, которые зависят от изменяемого справочника: документы, регистры, отчёты, обработки. Никаких сюрпризов после выгрузки в продуктив.
  • «Какой путь проходит документ при проведении?» - trace_call_chain строит полную карту вызовов: из формы в модуль объекта, из модуля объекта в общие модули, из общих модулей в регистры. Это даёт понимание архитектуры, которое обычно приходит только после месяцев изучения конфигурации.
  • «Какие документы ссылаются на этот справочник?» - search_metadata находит все объекты, у которых есть реквизиты ссылочного типа на указанный справочник, включая транзитивные связи через табличные части и другие объекты.
  • «ИИ не понимает архитектуру нашей конфигурации» - обычные AI-инструменты видят лишь изолированные объекты. Graph Metadata Search даёт ИИ граф связей, позволяя ему рассуждать о зависимостях, потоках данных и архитектурных паттернах.

⚡ Боль в цифрах

По нашим оценкам, анализ влияния изменений в конфигурации 1С из 500+ объектов занимает у разработчика от 2 до 8 часов, включая ручную проверку всех мест использования. Graph Metadata Search выполняет ту же задачу за секунды, а граф вызовов даёт понимание архитектуры, которое вручную нарабатывается месяцами.

«Graph Metadata Search - это не поисковик, это картограф конфигурации. Он не просто показывает, какие объекты есть - он показывает, как они связаны, какие влияют на какие и что произойдёт, если изменить конкретный объект. Для больших конфигураций 1С это незаменимый инструмент.»

- Команда OneRPA, разработчики сервера

Свойства и выгоды

🕸️ Neo4j на борту

Графовая база данных Neo4j встроена в сервер. Не нужно настраивать отдельный Neo4j кластер - всё работает в одном Docker-контейнере с автоматической загрузкой метаданных.

🔬 Комбинированный анализ

Четыре инструмента покрывают все сценарии: поиск (search_metadata), анализ влияния (trace_impact), навигация по вызовам (trace_call_chain) и полное досье (dossier). Вместе они дают ИИ беспрецедентное понимание конфигурации.

🚦 Предотвращение ошибок

trace_impact - это «страховка» для разработчика. Перед любым изменением можно запустить анализ и увидеть полную картину потенциального влияния. Никаких «сломали продуктив - узнали на утро».

🗺️ Визуализация архитектуры

Граф можно визуализировать - связи между объектами видны не только ИИ, но и разработчику. Это отличный инструмент для онбординга новых разработчиков, архитектурного ревью и документации.

Результат

С Graph Metadata Search ИИ-ассистент перестаёт быть просто «поисковиком по названиям» и становится архитектурным аналитиком, который понимает, как на самом деле устроена ваша конфигурация 1С:

  • Анализ влияния за секунды - trace_impact показывает все зависимые объекты до того, как вы сделали изменение.
  • Понимание архитектуры - ИИ не просто находит объекты, а понимает их взаимосвязи, потоки данных и архитектурные паттерны.
  • Безопасный рефакторинг - полная карта зависимостей позволяет дорабатывать конфигурацию без риска неожиданных поломок.
  • Онбординг новых разработчиков - граф связей даёт новым членам команды понимание архитектуры за минуты вместо недель.
  • Полная интеграция - работа через стандартный MCP-протокол с любым совместимым ассистентом (Claude Desktop, Codex, Continue.dev, Cursor и другие).

Graph Metadata Search - это эволюция работы с метаданными 1С. Вместо плоского списка объектов - граф связей. Вместо ручного анализа влияния - автоматический за секунды. Вместо догадок ИИ - точное понимание архитектуры.

🚀 Итог

Graph Metadata Search - MCP-сервер, который строит карту связей вашей 1С-конфигурации на Neo4j. Четыре инструмента: графовый поиск, анализ влияния, навигация по вызовам и полное досье. ИИ понимает не просто названия объектов, а их взаимосвязи. Предотвращает ошибки при доработках, ускоряет онбординг, делает рефакторинг безопасным.

Источник: Документация Graph Metadata Search на OneRPA Docs