MCP-граф конфигурации 1С на Neo4j

onec-mcp

Загружает XML-выгрузку конфигурации 1С в Neo4j и дает read-only MCP-доступ к метаданным, процедурам BSL и правам через текстовый и полнотекстовый поиск

  • 1 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Поднимает Docker-стек с Neo4j, который строит граф по XML-выгрузке 1С
  • MCP-инструменты только читают граф, загрузка выполняется отдельной командой
Все причины и проверки
Российский стек

youngpadovan/onec-mcp

Установка

Работает в

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

python scripts/docker/start_docker.py

Поднимает Neo4j и MCP-сервер, ждет готовности Neo4j и запускает load_config из ONEC_ERP_XML_HOST.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Поднимает Docker-стек с Neo4j, который строит граф по XML-выгрузке 1С
  • MCP-инструменты только читают граф, загрузка выполняется отдельной командой

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

Что делает

Docker-стек разбирает XML-выгрузку конфигурации 1С и строит граф в Neo4j: объекты метаданных, процедуры и функции BSL со связями CALLS, роли и права из Rights.xml. Агент получает около 25 MCP-инструментов: список типов метаданных, объекты и их карточки, роли по объекту, обзор с досье и индексом процедур, полный текст модуля или одной процедуры по qualified_name, граф вызовов на заданную глубину, сравнение прав двух ролей и доверенные Cypher-шаблоны для отчетов по графу. Поиск процедур и метаданных работает только по подстроке и полнотекстовому индексу Neo4j, без векторных эмбеддингов.

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

Подходит, если

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

Не подходит, если

  • Нужен полный статический анализ вызовов: граф CALLS эвристический и не разрешает динамическое Выполнить
  • Нужен семантический поиск по смыслу кода: доступен только текстовый и полнотекстовый поиск

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

Какие роли дают право на Справочник.Номенклатура и кто вызывает процедуру ПроверитьЗаказ

MCP

Транспорт
http
Авторизация
не нужна

Переменные окружения

ONEC_ERP_XML_HOST обязательная
Путь на хосте к корню XML-выгрузки конфигурации 1С.
NEO4J_PASSWORD обязательная, секрет
Пароль базы Neo4j, задается в docker/.env.
ONEC_OPENAI_API_KEY секрет
Ключ для опционального NL-в-Cypher перевода вопроса на русском языке.

Ограничения

Инструмент только читает граф, не пишет обратно в Neo4j и не запускает выгрузку из 1С сам. Граф вызовов CALLS собран эвристикой по тексту модулей, это не полный статический анализ. Один инстанс Neo4j держит одну конфигурацию, для второй нужен отдельный проект Compose. Для крупной ERP-выгрузки нужны десятки гигабайт RAM.

Как отключить. Остановите стек командой docker compose -f docker/docker-compose.yml down и удалите сервер из конфигурации MCP-клиента.

Частые вопросы

Использует ли поиск процедур векторные эмбеддинги?

Нет, поиск идет только по подстроке и полнотекстовому индексу Neo4j routine_search, без Ollama или векторных полей.

Можно ли писать в базу произвольный Cypher из чата?

Нет, доступны только dedicated tools и доверенные шаблоны из реестра, write-Cypher из чата не поддерживается.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Граф метаданных и кода конфигурации 1С в Neo4j с MCP-инструментами, веб-консолью и встроенным агентом поиска

MCP-серверРасширенный доступ111Звезды репозитория
Российский стек

MCP-сервер строит граф метаданных и вызовов по XML- и BSL-выгрузке конфигурации 1С, с опциональным семантическим поиском через внешний эмбеддер и Qdrant

MCP-серверРасширенный доступ4Звезды репозитория
Российский стек

Пять независимых MCP-серверов на Docker: граф метаданных и вызовов в Neo4j, анализ BSL, справка платформы, конструктор запросов и стандарты

MCP-серверРасширенный доступ
Российский стек

MCP-сервер и портативный администратор для анализа выгруженной XML-конфигурации 1С: поиск объектов, структура метаданных, поиск по коду

MCP-серверРасширенный доступ2Звезды репозитория
Российский стек

Локальный граф знаний конфигурации 1С для агента: Memgraph и ONNX-эмбеддинги без облака, для баз с сотнями тысяч процедур

MCP-серверРасширенный доступ12Звезды репозитория
Российский стек

Docker-сервер с read-only ядром и подключаемыми модулями: метаданные, код, формы и связи нескольких конфигураций 1С через единый MCP-контракт

MCP-серверРасширенный доступ12Звезды репозитория

Из блога

Коротко о README

Двуязычный README описывает поток от ONEC_ERP_XML_HOST через load_config до Neo4j и MCP на порту 8840, таблицу основных MCP-инструментов, принцип доверенных Cypher-шаблонов вместо произвольного write-Cypher, разделение ответственности между чатом, MCP и load_config, раздел безопасности про непубликуемые порты и обязательный пароль Neo4j, а также ограничения по эвристичности графа CALLS.

Бейдж для README

Сообщить о проблеме