1C Metacode MCP Server
Граф метаданных и кода конфигурации 1С в Neo4j с MCP-инструментами, веб-консолью и встроенным агентом поиска
Установка
docker compose up -dПеред запуском подготовьте .env и docker-compose.yml из примеров и разложите выгрузку по data/prj1.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер загружает в Neo4j метаданные конфигурации из отчета по конфигурации или XML-выгрузки, а также расширения, формы, роли, подписки на события и предопределенные значения. Из модулей он берет сигнатуры и тела процедур, строит граф вызовов и дает полнотекстовый, векторный и гибридный поиск по коду. Объекты связаны по реквизитам, движениям документов по регистрам и правам доступа, для объектов можно сгенерировать сводки через LLM. Агент получает все это через MCP, а человек через веб-консоль; данные подгружаются инкрементально по расписанию.
Для кого. Для команд 1С, которые сопровождают крупные конфигурации с расширениями и хотят дать агенту полную карту связей.
Подходит, если
- Нужно понять, какие объекты затронет изменение реквизита или регистра
- Конфигурация с несколькими расширениями и нужно сравнить их объекты с базовыми
- Нужен поиск процедур по смыслу, а не только по имени
Не подходит, если
- Нет возможности держать Docker с Neo4j на машине или сервере
- Хватает простого поиска по выгрузке без графовой базы
Пример запроса к агенту
Через 1c-metacode найди все документы, которые делают движения по регистру ВзаиморасчетыСКонтрагентами, и их обработчики проведенияОграничения
Нужны Docker, Docker Compose и свободные порты для Neo4j и сервера. Семантический поиск и сводки объектов требуют провайдера эмбеддингов или LLM, то есть ключей и, возможно, облачного API, доступность которого из России зависит от выбранного провайдера. Лицензия AGPL-3.0.
Как отключить. Удалите блок 1c-metacode из конфигурации MCP клиента и остановите контейнеры командой docker compose down.
MCP
- Транспорт
- http, sse
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| NEO4J_PASSWORD обязательная, секрет | Пароль пользователя neo4j |
| PROJECT_NAME обязательная | Имя проекта, совпадает с каталогом данных |
| WEB_CONSOLE_ENABLED | Включает веб-консоль |
| MCP_USE_SSE | Переключает транспорт на SSE |
Проверка безопасности
- Поднимает Neo4j и HTTP-сервер, MCP-эндпоинт без встроенной авторизации
- Может отправлять код и метаданные внешнему провайдеру эмбеддингов или LLM
Коротко о README
README описывает загружаемые данные и модель графа со схемой узлов и связей. Запуск идет через Docker Compose с Neo4j, после чего доступны Neo4j Browser, MCP-сервер по streamable HTTP или SSE и веб-консоль с токенами доступа. Справочник инструментов, режимы поиска, расширения и встроенный агент вынесены в отдельные документы в docs/. Лицензия AGPL-3.0.
Частые вопросы
Откуда берутся метаданные?
Из текстового отчета по конфигурации или напрямую из XML-выгрузки, код берется из XML-выгрузки.
Можно ли вести несколько баз?
Да, поддерживаются несколько проектов, каждый из базовой конфигурации и расширений, поиск фильтруется по проекту.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything