CodeMetadataSearchServer: поиск по метаданным и коду конфигурации 1С

190| 191|

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

194| 195|

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

196| 197|

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

198| 199|

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

200| 201|

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

205| 206|

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

207| 208|

209|

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

210|

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

211|

212| 213|

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

214| 215|

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

216| 217|

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

223| 224|

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

225| 226|

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

227| 228|

📁 Метаданные

229|

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

235| 236|

💻 Код (BSL)

237|

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

244| 245|

📄 Формы

246|

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

250| 251|

📚 Справка и XSD

252|

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

256| 257|

🔧 Служебные

258|

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

262| 263|

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

264| 265|

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

266| 267|

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

274| 275|

276|

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

277|

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

278|

279| 280|

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

284| 285|

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

286| 287|

288|

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

289|

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

290|

291| 292|

293|

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

294|

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

295|

296| 297|

298|

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

299|

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

300|

301| 302|

303|

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

304|

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

305|

306| 307|

308|

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

309|

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

310|

311| 312|

Результат

313| 314|

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

315| 316|

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

323| 324|

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

325| 326|

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

327| 328|

329|

🚀 Итог

330|

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

331|

332| 333|

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

334| 335|