1C MCP: поиск по структуре и коду конфигурации
1C MCP
Stdio MCP-сервер, который индексирует XML-выгрузку структуры 1С и код в SQLite и отдает агенту поиск по объектам и процедурам
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Сервер только читает индекс SQLite и не пишет в базу 1С
Установка
Ручная установка
docker compose run --rm --build index-structure && docker compose run --rm --build index-docs && docker compose run --rm -T mcpСобирает индекс структуры и документации и сразу запускает MCP-сервер, годится для первого запуска на новом ПК.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект не хранит саму конфигурацию 1С, а строит по ней индекс. Из XML-выгрузки структуры собираются таблицы SQLite с объектами метаданных, реквизитами и связями типов. Отдельно можно проиндексировать папку с экспортированным кодом 1С: индексатор ищет объявления и окончания процедур и функций на русском и английском синтаксисе и достает их в отдельные записи для поиска. Третий слой это документация: индексатор читает markdown, текст, html и pdf из папки docs и делает их доступными через инструмент search_docs. MCP-сервер работает по stdio и отдает агенту около десятка инструментов поиска по всем трем слоям сразу.
Для кого. Для разработчиков 1С, которые хотят дать агенту быстрый поиск по структуре и коду конкретной конфигурации без ручного грепа по выгрузке.
Подходит, если
- Есть XML-выгрузка структуры конфигурации и нужно быстро искать объекты и реквизиты
- Есть экспорт кода 1С и нужен поиск процедур и функций по имени или содержимому
- Хотите держать справочную документацию рядом с индексом кода для поиска в одном месте
Не подходит, если
- Нет ни XML-выгрузки структуры, ни экспорта кода, индексировать нечего
- Нужен доступ к живой базе 1С, а не к статическому индексу выгрузки
- Не готовы держать Docker Desktop запущенным ради индексации и работы сервера
Пример запроса к агенту
Найди процедуру, которая пересчитывает остатки по регистру Товары, и покажи ее исходный кодОграничения
Сервер работает только с готовыми выгрузками, а не с живой базой 1С напрямую. В репозитории вместе с кодом лежат несколько PDF-книг по 1С для примера индексации документации, происхождение и права на них не указаны, для своего проекта эту папку стоит заменить собственными материалами. Индексация без пересборки образа при смене Dockerfile не подхватит новые зависимости вроде pypdf.
Как отключить. Остановите контейнеры docker compose down, MCP-сервер запускается только по требованию клиента и не остается в фоне сам по себе.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| CODE_EXPORT_DIR | Путь на хосте к папке с экспортированным кодом 1С для индексации |
Проверка безопасности
- Сервер только читает индекс SQLite и не пишет в базу 1С
Коротко о README
README объясняет, что проект хранит индекс, а не саму конфигурацию, перечисляет таблицы SQLite и модули-индексаторы, показывает команды docker compose для запуска mcp-сервера и раздельной индексации структуры, кода и документации, дает пример конфигурации MCP-клиента через docker compose run и через прямой запуск python3 mcp/server.py, и описывает форматы, которые понимают индексаторы кода и документации.
Частые вопросы
Нужно ли переиндексировать при каждом изменении конфигурации?
Да, если поменялась XML-выгрузка структуры или появился новый экспорт кода, README советует пересобрать индекс соответствующей командой.
Можно ли работать без Docker?
Локальные скрипты parser/indexer.py, code_indexer.py, docs_indexer.py и search/search.py остаются как вспомогательные, но README рекомендует Docker как основной способ.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything