1C Metacode MCP Server

Загружает метаданные и код конфигураций 1С в графовую базу данных и предоставляет инструменты MCP для запросов по графу.

Основные возможности

• Загрузка всех метаданных конфигураций 1С в графовую базу Neo4j из отчета по конфигурации.
• Загрузка данных управляемых форм - реквизиты, элементы формы, события, команды. Привязка событий форм и элементов, команд к обработчикам.
• Загрузка предопределенных значений и прав ролей.
• Загрузка подписок на события и привязка к обработчикам.
• Загрузка сигнатур процедур/функций из всех модулей (включая модуль формы обычных форм), формирование графа вызовов.
• Загрузка описания и тела всех процедур и функций (включая модуль формы обычных форм) с полнотекстовым или гибридным поиском по описанию.
• Широкая связность объектов метаданных: в реквизитах, в элементах управлениях формы, в регистрах накопления/сведений, в правах доступа.
• MCP инструменты: search_metadata, search_metadata_by_description, search_code
• Поддержка загрузки и поиска информации по несколким конфигурациям (проектам). При поиске не нужно указывать в каком проекте искать. Система автоматически фильтрует.
• Возможность осуществлять поиск как с помощью LLM (режим агента, который переводить запрос на естественом языке в cypher запрос), так и без LLM (поиск по шаблонам). Возможен так же гибридный режим. Большинство информации может быть найдено по шаблонам.

Структура данных

graph TB
    %% Компактная вертикальная структура
    Project(["Project<br/>Проект"]) -->|"contains"| Configuration(["Configuration<br/>Конфигурация"])
    Configuration -->|"has"| MetadataCategory(["MetadataCategory<br/>Категория метаданных"])
    MetadataCategory -->|"contains"| MetadataObject(["MetadataObject<br/>Объект метаданных"])

    %% Формы и интерфейс (левая колонка)
    MetadataObject -->|"HAS_FORM"| Form(["Form<br/>Форма"])
    Form -->|"HAS_CONTROL"| FormControl(["FormControl<br/>Элемент формы"])
    Form -->|"HAS_EVENT"| FormEvent(["FormEvent<br/>Событие формы"])
    Form -->|"HAS_FORM_ATTRIBUTE"| FormAttribute(["FormAttribute<br/>Атрибут формы"])
    FormControl -->|"HAS_EVENT"| FormControlEvent(["FormEvent<br/>Событие элемента"])
    FormEvent -->|"HAS_HANDLER"| EventHandler(["Routine<br/>Обработчик события"])
    FormControlEvent -->|"HAS_HANDLER"| ControlEventHandler(["Routine<br/>Обработчик события"])

    %% Данные и атрибуты (правая колонка)
    MetadataObject -->|"HAS_ATTRIBUTE"| Attribute(["Attribute<br/>Атрибут"])
    MetadataObject -->|"HAS_TABULAR_PART"| TabularPart(["TabularPart<br/>Табличная часть"])
    MetadataObject -->|"HAS_RESOURCE"| Resource(["Resource<br/>Ресурс"])
    MetadataObject -->|"HAS_DIMENSION"| Dimension(["Dimension<br/>Измерение"])
    TabularPart -->|"HAS_ATTRIBUTE"| TabularAttribute(["Attribute<br/>Атрибут табл. части"])

    %% Связи и зависимости (нижняя секция)
    MetadataObject -->|"USED_IN"| UsedInTarget(["Target Object<br/>Целевой объект"])
    MetadataObject -->|"DO_MOVEMENTS_IN"| RegisterObject(["Register<br/>Регистр"])
    MetadataObject -->|"GRANTS_ACCESS_TO"| AccessTarget(["Access Target<br/>Цель доступа"])

    %% Модули и код (вертикальная цепочка)
    MetadataObject -->|"HAS_MODULE"| Module(["Module<br/>Модуль"])
    Module -->|"DECLARES"| Routine(["Routine<br/>Процедура/Функция"])
    Routine -->|"CALLS"| CalledRoutine(["Called Routine<br/>Вызываемая процедура"])

    %% Дополнительные компоненты (компактно)
    MetadataObject -->|"HAS_COMMAND"| Command(["Command<br/>Команда"])
    MetadataObject -->|"HAS_URL_TEMPLATE"| UrlTemplate(["UrlTemplate<br/>Шаблон URL"])
    MetadataObject -->|"HAS_EVENT_SUBSCRIPTION"| EventSubscription(["EventSubscription<br/>Подписка на событие"])
    MetadataObject -->|"HAS_PREDEFINED"| PredefinedItem(["PredefinedItem<br/>Предопределенный элемент"])

    %% Связи HTTP и форм (компактно)
    UrlTemplate -->|"HAS_URL_METHOD"| UrlMethod(["UrlMethod<br/>Метод URL"])
    UrlMethod -->|"HAS_HANDLER"| UrlHandler(["Routine<br/>Обработчик HTTP"])
    FormControl -->|"BINDS_TO"| BindTarget(["Bind Target<br/>Цель связывания"])
    FormControl -->|"LINKS_TO_COMMAND"| LinkedCommand(["Command<br/>Команда"])

    %% Новые добавления: дополнительные сущности и связи
    MetadataObject -->|"HAS_LAYOUT"| Layout(["Layout<br/>Макет"])
    MetadataObject -->|"HAS_CHARACTERISTIC"| Characteristic(["Characteristic<br/>Характеристика"])
    MetadataObject -->|"HAS_ENUM_VALUE"| EnumValue(["EnumValue<br/>ЗначениеПеречисления"])
    MetadataObject -->|"HAS_GRAPH"| JournalGraph(["JournalGraph<br/>Граф журнала"])
    MetadataObject -->|"HAS_ACCOUNTING_FLAG"| AccountingFlag(["AccountingFlag<br/>ПризнакУчета"])
    MetadataObject -->|"HAS_DIMENSION_ACCOUNTING_FLAG"| DimensionAccountingFlag(["DimensionAccountingFlag<br/>ПризнакУчетаСубконто"])
    MetadataObject -->|"CONTAINS_OBJECT"| SubsystemChild(["MetadataObject<br/>Дочерний объект<br/>(подсистемы)"])
    PredefinedItem -->|"HAS_CHILD"| PredefinedChild(["PredefinedItem<br/>Дочерний элемент"])
    FormControl -->|"HAS_CHILD"| FormControlChild(["FormControl<br/>Дочерний элемент"])
    Form -->|"HAS_COMMAND"| FormCommand(["Command<br/>Команда формы"])
    EventSubscription -->|"HAS_HANDLER"| EventSubHandler(["Routine<br/>Обработчик подписки"])
    Command -->|"HAS_HANDLER"| CommandHandler(["Routine<br/>Обработчик команды"])
    FormCommand -->|"HAS_HANDLER"| FormCommandHandler(["Routine<br/>Обработчик команды формы"])

    %% Уникальные стили для каждого типа узла (упрощено, без лишних подтипов)
    classDef projectClass fill:#FF6B6B,stroke:#C92A2A,stroke-width:2px,color:#FFFFFF
    classDef configClass fill:#4ECDC4,stroke:#26A69A,stroke-width:2px,color:#FFFFFF
    classDef categoryClass fill:#45B7D1,stroke:#1976D2,stroke-width:2px,color:#FFFFFF
    classDef objectClass fill:#96CEB4,stroke:#388E3C,stroke-width:2px,color:#FFFFFF
    classDef formClass fill:#FFEAA7,stroke:#FD8D3C,stroke-width:2px,color:#000000
    classDef formControlClass fill:#AED6F1,stroke:#3498DB,stroke-width:2px,color:#FFFFFF
    classDef formEventClass fill:#FF69B4,stroke:#C2185B,stroke-width:2px,color:#FFFFFF
    classDef formAttrClass fill:#A3E4D7,stroke:#1ABC9C,stroke-width:2px,color:#000000
    classDef attributeClass fill:#85C1E9,stroke:#2980B9,stroke-width:2px,color:#FFFFFF
    classDef tabularClass fill:#F7DC6F,stroke:#F39C12,stroke-width:2px,color:#000000
    classDef resourceClass fill:#F8C471,stroke:#E67E22,stroke-width:2px,color:#000000
    classDef dimensionClass fill:#82E0AA,stroke:#27AE60,stroke-width:2px,color:#FFFFFF
    classDef targetClass fill:#CACFD2,stroke:#7F8C8D,stroke-width:2px,color:#000000
    classDef moduleClass fill:#98D8C8,stroke:#16A085,stroke-width:2px,color:#FFFFFF
    classDef routineClass fill:#F1948A,stroke:#E74C3C,stroke-width:2px,color:#FFFFFF
    classDef commandClass fill:#E1BEE7,stroke:#9C27B0,stroke-width:2px,color:#FFFFFF
    classDef urlTemplateClass fill:#F9E79F,stroke:#F1C40F,stroke-width:2px,color:#000000
    classDef urlMethodClass fill:#D98880,stroke:#CD6155,stroke-width:2px,color:#FFFFFF
    classDef eventSubClass fill:#AEB6BF,stroke:#5D6D7E,stroke-width:2px,color:#FFFFFF
    classDef predefinedClass fill:#BB8FCE,stroke:#8E44AD,stroke-width:2px,color:#FFFFFF
    classDef bindTargetClass fill:#D5DBDB,stroke:#BDC3C7,stroke-width:2px,color:#000000
    classDef layoutClass fill:#F0E68C,stroke:#DAA520,stroke-width:2px,color:#000000
    classDef characteristicClass fill:#DEB887,stroke:#CD853F,stroke-width:2px,color:#000000
    classDef enumValueClass fill:#FFA07A,stroke:#FF6347,stroke-width:2px,color:#FFFFFF
    classDef journalGraphClass fill:#20B2AA,stroke:#008B8B,stroke-width:2px,color:#FFFFFF
    classDef accountingFlagClass fill:#87CEEB,stroke:#4682B4,stroke-width:2px,color:#FFFFFF
    classDef dimensionAccountingFlagClass fill:#DDA0DD,stroke:#BA55D3,stroke-width:2px,color:#FFFFFF
    classDef subsystemChildClass fill:#A8E6CF,stroke:#3D9970,stroke-width:2px,color:#FFFFFF
    classDef formControlChildClass fill:#B3E5FC,stroke:#03A9F4,stroke-width:2px,color:#FFFFFF
    classDef tabularAttributeClass fill:#90CAF9,stroke:#2196F3,stroke-width:2px,color:#FFFFFF

    %% Применение цветов (упрощено)
    class Project projectClass
    class Configuration configClass
    class MetadataCategory categoryClass
    class MetadataObject,SubsystemChild subsystemChildClass
    class Form formClass
    class FormControl,FormControlChild formControlChildClass
    class FormEvent formEventClass
    class FormAttribute formAttrClass
    class Attribute,TabularAttribute tabularAttributeClass
    class TabularPart tabularClass
    class Resource resourceClass
    class Dimension dimensionClass
    class UsedInTarget,RegisterObject,AccessTarget targetClass
    class Module moduleClass
    class Routine,CalledRoutine,EventHandler,ControlEventHandler,UrlHandler,EventSubHandler,CommandHandler,FormCommandHandler routineClass
    class Command,FormCommand,LinkedCommand commandClass
    class UrlTemplate urlTemplateClass
    class UrlMethod urlMethodClass
    class EventSubscription eventSubClass
    class PredefinedItem,PredefinedChild predefinedClass
    class BindTarget bindTargetClass
    class Layout layoutClass
    class Characteristic characteristicClass
    class EnumValue enumValueClass
    class JournalGraph journalGraphClass
    class AccountingFlag accountingFlagClass
    class DimensionAccountingFlag dimensionAccountingFlagClass

Быстрый старт

• Docker и Docker Compose
• Свободные порты 7474/7687 (Neo4j) и 6001 (MCP)

1. Подготовьте .env

   Скопируйте пример и заполните значения (минимум пароль Neo4j):

   Обязательно задайте пароль Neo4j NEO4J_PASSWORD=...

   В файле .env указываются значение, которые общие для всех контейнеров. Значения, которые различаются для каждого контейнера лучше указывать непосредственно в docker-compose.yml

2. Подготовьте docker-compose.yml

   Скопируйте пример docker-compose.example.yml в туже папку где у вас файл .env и переименуйте в docker-compose.yml

   Задайте PROJECT_NAME в сервисе 1c-metacode-prj1 (можно переименовать название сервиса как нравится) Если у вас только один проект, то второй сервис 1c-metacode-prj2 можно удалить полностью Если нужно больше двух то продублируйте секцию сервиса и обязательно задайте другой порт на хосте ( меняем только первый порт в этой строке "6001:6001") и другой PROJECT_NAME

3. Разместите данные

   В корне папки где располагаются файлы .env и docker-compose.yml создайте структуру для монтирования в контейнер:

   • ./data/prj1/metadata — Выгрузка отчет по конфигурации в формате .txt (в папке должен быть только один txt файл). В конфигураторе Конфигурация -> Отчет по конфигурации (в текстовый файл, Вся конфигурация)
   • ./data/prj1/code — Выгрузка конфигурации в файлы. В конфигураторе Конфигурация -> Выгрузить конфигурацию в файлы (XML-файлы)

   Аналогично по другим проектам:

   • ./data/prj2/metadata
   • ./data/prj2/code

4. Запуск

docker compose up -d

Сервисы

• Neo4j: http://localhost:7474 (логин neo4j / пароль из NEO4J_PASSWORD)
• Bolt: bolt://localhost:7687
• MCP сервер: http://localhost:6001/mcp (и другие порты, указанные в docker-compose.yml)

Логи приложения

docker compose logs -f 1c-metacode-prj1

Первичный запуск

• Приложение создаст индексы в Neo4j
• Проведёт загрузку метаданных из ./data/metadata/*.txt
• При включённых флагах — просканирует ./data/code и догрузит формы, предопределённые значения, права, подписки на события, модули с процедурами и функциями
• Загрузка всех данных (без векторной индексации) занимает около 30 минут для типовой конфигурации Бухгалтерия (может увеличиться если слабый компьютер)
• При включенной векторной индексации она запускается в фоне, после загрузки всех данных. MCP сервер во время векторной индексации доступен для запросов.
• Векторная индексация описаний метадананных и процедур/функций занимает около 30 минут для типовой конфигурации Бухгалтерия с использованием модели Qwen3-Embedding-4B_Q8 на 5070Ti
• Для загрузки требуется оперативной памяти из расчета 4 ГБ для Neo4j и по 6 ГБ на каждую одновременно загружаемую базу. После загрузки потребление памяти значительно снижается.

Обновление/перезагрузка данных

• Для полной перезагрузки данных проекта установите в docker-compose.yml переменную для соответсвующего проекта и перезапустите контейнер:

FULL_METADATA_RELOAD=true
docker compose restart 1c-metacode-prj1

Инструменты MCP

Сервер публикует 3 инструмента:

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

Более подробно в Описание возможностей MCP сервера

Транспорт:

• По умолчанию streamable-http (HTTP путь /mcp)
• При MCP_USE_SSE=true — SSE-режим

Подключение клиентов Используйте любой MCP-совместимый клиент (например, IDE/агенты с поддержкой OpenAI MCP). Укажите:

• transport: streamable-http или sse
• endpoint: http://localhost:6001/mcp

Пример mcp.json для Cline

{
  "mcpServers": {
    "1c-metacode": {
      "url": "http://localhost:6001/mcp",
      "connection_id": "1c_metacode_service_001",
      "alwaysAllow": [],
      "type": "streamable-http",
      "timeout": 300

    }
  }
}

Обновление

Для обновления на новую версию приложения

docker compose pull
docker compose down --volumes
docker compose up -d --force-recreate

Если нужно начать всё с нуля и удалить полностью базу то выполните

docker compose down --volumes
docker compose up -d --force-recreate

Changelog

v1.3.0 - 2025-10-29

• Добавлена поддержка загрузки процедур/функций из модуля формы обычных форм (файлы Form.bin).
• Улучшена скорость загрузки (примерно в 2 раза) путем распараллеливания процесса загрузки на несколько ядер.
• Добавлена векторная индексация описаний процедур/функций, описаний метаданных, а так же гибридный поиск по этим описаниям.

v1.2.0 - 2025-10-20

• Добавлена загрузка тела процедур и функций, а также их описаний (комментарии над сигнатурой).
• Возможность полнотекстового поиска процедур и функций по описанию.
• Возможность получения тела процедуры/функции прямо из графовой базы.
• Добавлена поддержка загрузки справки по объектам метаданным с возможностью полнотекстового поиска объектов метаданных по этой справке, а так же по другим описательным полям.

v1.1.0 - 2025-10-07

• Добавлена поддержка загрузки подписок на события
• Добавлена поддержка загрузки модулей с процедурами/функциями и формирования графа вызовов

v1.0.0 - 2025-09-30

• Первоначальный релиз с загрузкой метаданных 1С в Neo4j
• Поддержка MCP инструментов для поиска метаданных