CodeMetadataSearchServer - это комплексный MCP сервер 1С, который даёт ИИ-ассистентам полное понимание структуры вашей конфигурации: от метаданных и BSL-кода до HTML-справки и XSD-схем. Если обычные AI-инструменты работают «вслепую» с конфигурацией 1С, то CodeMetadataSearchServer снабжает их точной картой всех объектов, реквизитов, модулей и вызовов.

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

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

CodeMetadataSearchServer - это MCP-сервер (Model Context Protocol), который запускается в Docker-контейнере и индексирует выгрузку конфигурации 1С, полученную двумя способами:

  • Отчёт по метаданным - XML-файл со структурой всех объектов конфигурации, их реквизитами, типами, предопределёнными элементами.
  • Файлы модулей - исходный код на BSL из всех модулей конфигурации (общие модули, модули объектов, модули форм, модули менеджеров и т.д.).

Сервер использует векторную базу данных ChromaDB и встроенную embedding-модель для семантического поиска по коду. Инструменты сервера сгруппированы по четырём областям: метаданные, код, справка и XSD-схемы - плюс служебные инструменты для проверки статуса и конфигурации.

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

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

Как работает CodeMetadataSearchServer

Архитектура сервера построена вокруг идеи «всё включено» - одного контейнера, который умеет работать со всеми аспектами конфигурации 1С:

  1. Индексация метаданных: На вход подаётся XML-отчёт по метаданным из Конфигуратора. Сервер парсит его, извлекает все объекты, их реквизиты, типы, предопределённые элементы, подчинённые объекты и выстраивает древовидную структуру.
  2. Индексация кода: Файлы модулей (.bsl, формы, расширения) загружаются в ChromaDB. Каждый модуль разбивается на смысловые фрагменты - функции, процедуры, участки кода - которые индексируются для семантического поиска.
  3. Индексация справки и XSD: HTML-файлы справки конфигурации и XML-схемы (XSD) также индексируются, что позволяет искать по ним как по смыслу, так и по точному совпадению.
  4. 15 инструментов: Каждый инструмент отвечает за свою задачу - от поиска объекта метаданных до построения полного графа вызовов для функции.

15 инструментов - полный арсенал

CodeMetadataSearchServer предоставляет 15 инструментов, разделённых на четыре группы:

📁 Метаданные

  • Поиск объектов метаданных - находит объекты по имени, синониму, комментарию или описанию. Поддерживает семантический поиск.
  • Детальная структура объекта - показывает все реквизиты, табличные части, измерения, ресурсы, реквизиты, типы данных, предопределённые элементы.
  • Поиск по типу данных - находит все объекты, использующие указанный тип (например, все реквизиты типа «СправочникСсылка.Контрагенты»).
  • Иерархия подчинённых объектов - отображает полное дерево подчинённых объектов для выбранного элемента метаданных.

💻 Код (BSL)

  • Семантический поиск по коду - ищет фрагменты кода по смыслу, а не по ключевым словам. Опишите, что должна делать функция, и сервер найдёт похожие участки.
  • Точный поиск функций и процедур - находит точное определение функции или процедуры по имени, включая сигнатуру, параметры и полный текст.
  • Иерархия вызовов методов - строит граф: какие методы вызывает данная функция и какие методы вызывают её. Позволяет понять влияние изменений.
  • Поиск по шаблону / регулярному выражению - для случаев, когда нужен точный grep-поиск по коду с поддержкой регулярных выражений.
  • Список всех глобальных переменных и экспортных функций - даёт полную картину доступного API конфигурации.

📄 Формы

  • Поиск форм - находит формы по имени объекта или названию формы.
  • Структура формы - показывает реквизиты формы, элементы, команды, обработчики, типы элементов.

📚 Справка и XSD

  • Поиск по HTML-справке конфигурации - семантический и полнотекстовый поиск по встроенной справке.
  • Поиск по XSD-схемам - находит XML-схемы, используемые для обмена данными (XDTO, веб-сервисы).

🔧 Служебные

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

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

CodeMetadataSearchServer решает проблемы, знакомые каждому разработчику 1С, работающему с большими или Legacy-конфигурациями:

  • «А где у нас этот реквизит?» - в конфигурации из 500+ объектов невозможно помнить, у каких справочников и документов есть реквизит «Статус» и какие типы он принимает. Сервер находит это за секунду.
  • «Кто вызывает эту функцию?» - перед рефакторингом нужно понять, где используется функция. Иерархия вызовов CodeMetadataSearchServer показывает все места вызова и все вызываемые подфункции.
  • «Что за тип данных у этого реквизита?» - типы в 1С сложные: составные типы, ссылки на конкретные справочники, пересечения типов. Сервер показывает точную структуру типов для любого реквизита.
  • «ИИ пишет код, но не знает нашу конфигурацию» - ChatGPT и Claude не видят вашу мета-структуру. Без CodeMetadataSearchServer они генерируют обобщённый код, который может ссылаться на несуществующие реквизиты или игнорировать вашу специфику.
  • «Где в справке описание этого объекта?» - HTML-справка конфигурации может содержать сотни страниц. Векторный поиск по справке находит нужную информацию без ручного перебора.

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

По нашим оценкам, разработчик на 1С тратит от 3 до 6 часов в неделю на навигацию по конфигурации: поиск объектов, реквизитов, мест вызова функций, проверку типов данных. CodeMetadataSearchServer сокращает это время до секунд - ИИ делает всю работу по поиску и анализу, а разработчик занимается только принятием решений и написанием кода.

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

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

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

🔍 Семантический и точный поиск

Два режима в одном сервере. Не помните точное имя объекта? Опишите его словами - семантический поиск найдёт по смыслу. Знаете точное имя? Точный поиск вернёт результат мгновенно, без семантического «шума».

🌳 Иерархия вызовов методов

Уникальная возможность: сервер строит полный граф вызовов для любой функции или процедуры. Вы видите, какие методы вызываются из данного модуля и какие модули вызывают его. Без этого безопасный рефакторинг в большой конфигурации практически невозможен.

📋 Детальная структура реквизитов и типов

Для каждого объекта метаданных сервер показывает полную картину: реквизиты с типами, табличные части с реквизитами, предопределённые элементы, измерения, ресурсы. Составные типы раскрываются до конкретных ссылок - больше никаких «Реф.Ссылка» без понимания, на что именно.

📚 HTML-справка и XSD-схемы

Встроенная HTML-справка конфигурации и XSD-схемы также индексируются. Можно искать по смыслу в справке (описания объектов, инструкции) и находить XML-схемы для обмена данными.

🎯 15 инструментов в одном сервере

Вам не нужно устанавливать несколько разных MCP-серверов для работы с метаданными, кодом, формами и справкой. CodeMetadataSearchServer объединяет всё в одном Docker-контейнере с единым API.

Результат

С CodeMetadataSearchServer ИИ-ассистент понимает вашу конфигурацию 1С как опытный разработчик, который работал с ней годами. Это означает:

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

CodeMetadataSearchServer - это не просто утилита для поиска. Это фундамент, на котором строится полноценная AI-разработка для 1С. Без него ИИ работает вслепую. С ним - становится экспертом по вашей конфигурации.

Если вы используете AI-ассистентов в разработке на 1С - HelpSearchServer (для справки платформы) и CodeMetadataSearchServer (для вашей конфигурации) - это два сервера, которые должны быть в вашем арсенале в первую очередь.

🚀 Итог

CodeMetadataSearchServer - самый мощный MCP-сервер для работы с конфигурациями 1С. 15 инструментов, семантический и точный поиск, иерархия вызовов, полная структура метаданных - всё это даёт ИИ то же понимание конфигурации, которое есть у опытного разработчика-эксперта. Находит объекты и код за секунды. Ускоряет разработку, снижает количество ошибок и делает рефакторинг безопасным.

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