1C MCP Suite: набор серверов для конфигурации 1С
1C MCP Suite
Пять независимых MCP-серверов на Docker: граф метаданных и вызовов в Neo4j, анализ BSL, справка платформы, конструктор запросов и стандарты
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Индексаторы читают весь код и метаданные конфигурации 1С в свои базы Neo4j и Qdrant
- Скрытые инструменты metadata_reload и metadata_cypher выполняют произвольные операции над графом, если явно включены флагом
Установка
- Работает в
- Сервисы
Ручная установка
docker compose build && docker compose up -dПеред запуском заполнить .env секретами MCP_SHARED_SECRET и NEO4J_PASSWORD, иначе серверы завершатся с кодом 78.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Индексаторы читают весь код и метаданные конфигурации 1С в свои базы Neo4j и Qdrant
- Скрытые инструменты metadata_reload и metadata_cypher выполняют произвольные операции над графом, если явно включены флагом
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор поднимает пять MCP-серверов по Streamable HTTP, каждый со своим хранилищем данных. Metadata-graph строит в Neo4j граф структуры конфигурации и граф вызовов процедур по XML-выгрузке и BSL-коду, отвечая на вопросы вроде «кто вызывает эту функцию» или «какие объекты не входят ни в одну подсистему». Bsl-checker оборачивает BSL Language Server и проверяет код или каталог на соответствие стандартам. Platform-help делает гибридный поиск (векторный плюс BM25) по официальной справке платформы из файлов .hbk через Qdrant. Query-builder читает тот же граф метаданных и помогает строить, проверять и разбирать запросы на языке запросов 1С. Пятый сервер, v8std-mcp, не написан авторами проекта, а подключен из стороннего репозитория zeegin/v8std с текстами стандартов разработки. Все свои серверы возвращают в ответах поля answerable и degraded, чтобы агент не путал пустой результат с отказом инструмента.
Для кого. Для 1С-разработчиков и команд, которым нужно, чтобы агент понимал конкретную конфигурацию: ее объекты, связи, код и соответствие стандартам.
Подходит, если
- Нужен агенту граф вызовов и метаданных по конкретной конфигурации, а не общая справка
- Хотите проверять код 1С статическим анализом прямо из диалога с агентом
- Нужен локальный офлайн поиск по синтакс-помощнику платформы и стандартам разработки
Не подходит, если
- Нет Docker Desktop с лимитом памяти хотя бы 8 ГБ
- Не готовы ждать первую индексацию: у справки это час-полтора на CPU
- Нужен простой единичный MCP-сервер, а не инфраструктура из пяти контейнеров плюс Neo4j и Qdrant
Пример запроса к агенту
Найди все процедуры, которые работают с документом ЗаказПокупателя, и покажи, есть ли среди них мертвый код без входящих вызововMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
MCP_SHARED_SECRETобязательная, секрет- Общий секрет для bearer-авторизации своих серверов, без него они не стартуют
NEO4J_PASSWORDобязательная, секрет- Пароль базы Neo4j, задается только при первой инициализации тома
WATCHER_ENABLED- Включает автообновление графа при сохранении файла выгрузки
Ограничения
Первая сборка образов занимает 10-15 минут, а первая индексация справки платформы час-полтора на CPU. Без заполненных секретов MCP_SHARED_SECRET и NEO4J_PASSWORD серверы не стартуют. Транспорт только Streamable HTTP, SSE не поддерживается. Сервер v8std-mcp публичный вариант отправляет фрагменты кода на внешний адрес ai.v8std.ru, поэтому по умолчанию сделан локальный запуск с собственным корпусом стандартов. Требуется XML-выгрузка конфигурации и файлы справки .hbk, без них смысла в развертывании нет. Windows отдает файловые события через bind-mount с задержкой, поэтому автообновление графа по умолчанию выключено.
Как отключить. Остановите набор командой docker compose down, а для удаления данных индексов добавьте флаг -v.
Частые вопросы
Зачем отдельный сервер только для статического анализа?
Bsl-checker единственный без хранилища и состояния: он оборачивает BSL Language Server и всегда отвечает актуальной проверкой, не завися от того, готов ли граф метаданных.
Можно ли подключить публичный v8std вместо локального?
Да, одной строкой в конфиге клиента на адрес https://ai.v8std.ru/mcp, но тогда фрагменты кода будут уходить на сторонний сервер, что подходит не для всех проектов.
Обсуждение
Вопросов и отзывов пока нет.
Набор MCP-серверов для разработки 1С
1C MCP Toolkit
Десять MCP-серверов для разработки 1С: справка платформы, точечная выгрузка и загрузка объектов, COM, хранилище, поиск по файлам и BSL Language Server
Docker-сервер с read-only ядром и подключаемыми модулями: метаданные, код, формы и связи нескольких конфигураций 1С через единый MCP-контракт
MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL
HTTP MCP-шлюз для 1С с дашбордом
onec-mcp-universal
Docker-шлюз на 40 с лишним MCP-инструментов для 1С с одним адресом, веб-дашбордом настроек и набором скиллов 1С для Claude Code
Набор MCP-серверов для 1С в Docker
MCP-серверы для 1С
Docker Compose с набором MCP-серверов для разработки 1С в Cursor: синтаксис, справка платформы, БСП, формы, графовый поиск по конфигурации
Docker-развертывание MCP-серверов для 1С
MCP-серверы для 1С:Enterprise
Готовые Docker Compose файлы и скрипты управления для девяти MCP-серверов 1С:Enterprise: справка, метаданные, графовый поиск, проверка синтаксиса
Коротко о README
README на 800 с лишним строк подробно описывает состав из пяти серверов с портами и числом инструментов, требования к памяти Docker, пошаговую установку секретов и проверку окружения, устройство каждого сервера и его инструментов, разницу между полной и частичной переиндексацией выгрузки, повседневные команды docker compose и обширный раздел troubleshooting с конкретными симптомами вроде кода выхода 78 или ошибки 503 из-за системного прокси Windows.