MCP поиска по метаданным 1С
mcp1c_metadata
Docker-сервис, который индексирует JSON-выгрузку метаданных конфигураций 1С и дает агенту быстрый поиск объектов по имени и синониму
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Сервис только ищет по заранее выгруженному JSON, доступа к живой базе или записи нет
- Docker-контейнер публикует порт наружу, стоит ограничить его сетевым доступом
Установка
Ручная установка
docker run --rm -it -p 8007:8000 -v "C:\ERP\Report":/app/metadata_src -e MCP_PORT=8000 -e MCP_PATH=/mcp smirnov0ser/mcp1c_metadata:latestБыстрый старт из готового образа Docker Hub, из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервис читает JSON-файлы метаданных, полученные обработкой ВыгрузитьМетаданныевJson.epf, и строит краткий индекс для быстрых подсказок. Единственный инструмент metadatasearch ищет объект по полному имени вроде Справочники.Номенклатура с ограничением количества результатов и умеет работать с несколькими конфигурациями одновременно, выбирая нужную по параметру config. Типы автоматически нормализуются к единственному числу, а суффикс Ссылка обрезается. Сервис разворачивается в Docker с портами и томами для исходных метаданных, индекса и логов, либо локально через pip и venv на Python 3.12.
Для кого. Для 1С-разработчиков, которым нужен быстрый поиск объектов метаданных по имени для ИИ-агентов в браузере или IDE.
Подходит, если
- Нужно быстро найти полное имя объекта метаданных по названию или синониму
- Работаете с несколькими конфигурациями 1С одновременно и нужен общий поисковый сервис
- Нужен легкий Docker-сервис без установки расширений в саму базу 1С
Не подходит, если
- Нужен живой доступ к данным базы, а не к статичной JSON-выгрузке метаданных
- Нет возможности регулярно обновлять выгрузку через обработку ВыгрузитьМетаданныевJson.epf
Пример запроса к агенту
Найди полное имя объекта метаданных для регистра настроек пользователяОграничения
Больше года без пушей, лицензия не указана. Сервис работает с заранее выгруженным JSON, а не с живой базой, поэтому актуальность зависит от того, как часто обновляется выгрузка. Параметр find_usages в инструменте зарезервирован, но пока не используется.
Как отключить. Остановите и удалите контейнер mcp1c_metadata, уберите сервер из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| INPUT_METADATA_DIR | Путь к исходным JSON-файлам метаданных, по умолчанию /app/metadata_src. |
| MCP_PORT | Порт MCP-сервера внутри контейнера, по умолчанию 8000. |
Проверка безопасности
- Сервис только ищет по заранее выгруженному JSON, доступа к живой базе или записи нет
- Docker-контейнер публикует порт наружу, стоит ограничить его сетевым доступом
Коротко о README
README описывает назначение сервиса, где он используется (расширение MCP SuperAssistant, Cursor, Void), быстрый старт через Docker с примером команды и переменными окружения, локальный запуск без Docker, структуру каталогов метаданных, единственный инструмент metadatasearch с параметрами и рекомендованный промпт-инструктаж для агента.
Частые вопросы
Как получить JSON-выгрузку для сервиса?
Обработкой ВыгрузитьМетаданныевJson.epf, которая идет в комплекте с репозиторием.
Можно ли держать несколько конфигураций одновременно?
Да, сервис строит индекс по нескольким JSON-файлам и позволяет выбрать конфигурацию параметром config.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything