1C MCP Suite: набор серверов для конфигурации 1С
1C MCP Suite
Пять независимых MCP-серверов на Docker: граф метаданных и вызовов в Neo4j, анализ BSL, справка платформы, конструктор запросов и стандарты
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Индексаторы читают весь код и метаданные конфигурации 1С в свои базы Neo4j и Qdrant
- Скрытые инструменты metadata_reload и metadata_cypher выполняют произвольные операции над графом, если явно включены флагом
Установка
Ручная установка
docker compose build && docker compose up -dПеред запуском заполнить .env секретами MCP_SHARED_SECRET и NEO4J_PASSWORD, иначе серверы завершатся с кодом 78.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор поднимает пять 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
Пример запроса к агенту
Найди все процедуры, которые работают с документом ЗаказПокупателя, и покажи, есть ли среди них мертвый код без входящих вызововОграничения
Первая сборка образов занимает 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.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MCP_SHARED_SECRET обязательная, секрет | Общий секрет для bearer-авторизации своих серверов, без него они не стартуют |
| NEO4J_PASSWORD обязательная, секрет | Пароль базы Neo4j, задается только при первой инициализации тома |
| WATCHER_ENABLED | Включает автообновление графа при сохранении файла выгрузки |
Проверка безопасности
- Индексаторы читают весь код и метаданные конфигурации 1С в свои базы Neo4j и Qdrant
- Скрытые инструменты metadata_reload и metadata_cypher выполняют произвольные операции над графом, если явно включены флагом
Коротко о README
README на 800 с лишним строк подробно описывает состав из пяти серверов с портами и числом инструментов, требования к памяти Docker, пошаговую установку секретов и проверку окружения, устройство каждого сервера и его инструментов, разницу между полной и частичной переиндексацией выгрузки, повседневные команды docker compose и обширный раздел troubleshooting с конкретными симптомами вроде кода выхода 78 или ошибки 503 из-за системного прокси Windows.
Частые вопросы
Зачем отдельный сервер только для статического анализа?
Bsl-checker единственный без хранилища и состояния: он оборачивает BSL Language Server и всегда отвечает актуальной проверкой, не завися от того, готов ли граф метаданных.
Можно ли подключить публичный v8std вместо локального?
Да, одной строкой в конфиге клиента на адрес https://ai.v8std.ru/mcp, но тогда фрагменты кода будут уходить на сторонний сервер, что подходит не для всех проектов.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything