1C MCP: поиск по структуре и коду конфигурации

1C MCP

Stdio MCP-сервер, который индексирует XML-выгрузку структуры 1С и код в SQLite и отдает агенту поиск по объектам и процедурам

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • В Docker строит индекс SQLite по XML-выгрузке, коду и документации 1С
  • MCP-сервер только читает этот индекс, живую базу не трогает
Все причины и проверки
Российский стек

rezuqq/1c-mcp

Установка

Работает в

Ручная установка

docker compose run --rm --build index-structure && docker compose run --rm --build index-docs && docker compose run --rm -T mcp

Собирает индекс структуры и документации и сразу запускает MCP-сервер, годится для первого запуска на новом ПК.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • В Docker строит индекс SQLite по XML-выгрузке, коду и документации 1С
  • MCP-сервер только читает этот индекс, живую базу не трогает

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект не хранит саму конфигурацию 1С, а строит по ней индекс. Из XML-выгрузки структуры собираются таблицы SQLite с объектами метаданных, реквизитами и связями типов. Отдельно можно проиндексировать папку с экспортированным кодом 1С: индексатор ищет объявления и окончания процедур и функций на русском и английском синтаксисе и достает их в отдельные записи для поиска. Третий слой это документация: индексатор читает markdown, текст, html и pdf из папки docs и делает их доступными через инструмент search_docs. MCP-сервер работает по stdio и отдает агенту около десятка инструментов поиска по всем трем слоям сразу.

Для кого. Для разработчиков 1С, которые хотят дать агенту быстрый поиск по структуре и коду конкретной конфигурации без ручного грепа по выгрузке.

Подходит, если

  • Есть XML-выгрузка структуры конфигурации и нужно быстро искать объекты и реквизиты
  • Есть экспорт кода 1С и нужен поиск процедур и функций по имени или содержимому
  • Хотите держать справочную документацию рядом с индексом кода для поиска в одном месте

Не подходит, если

  • Нет ни XML-выгрузки структуры, ни экспорта кода, индексировать нечего
  • Нужен доступ к живой базе 1С, а не к статическому индексу выгрузки
  • Не готовы держать Docker Desktop запущенным ради индексации и работы сервера

Пример запроса к агенту

Найди процедуру, которая пересчитывает остатки по регистру Товары, и покажи ее исходный код

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

CODE_EXPORT_DIR
Путь на хосте к папке с экспортированным кодом 1С для индексации

Ограничения

Сервер работает только с готовыми выгрузками, а не с живой базой 1С напрямую. В репозитории вместе с кодом лежат несколько PDF-книг по 1С для примера индексации документации, происхождение и права на них не указаны, для своего проекта эту папку стоит заменить собственными материалами. Индексация без пересборки образа при смене Dockerfile не подхватит новые зависимости вроде pypdf.

Как отключить. Остановите контейнеры docker compose down, MCP-сервер запускается только по требованию клиента и не остается в фоне сам по себе.

Частые вопросы

Нужно ли переиндексировать при каждом изменении конфигурации?

Да, если поменялась XML-выгрузка структуры или появился новый экспорт кода, README советует пересобрать индекс соответствующей командой.

Можно ли работать без Docker?

Локальные скрипты parser/indexer.py, code_indexer.py, docs_indexer.py и search/search.py остаются как вспомогательные, но README рекомендует Docker как основной способ.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер и портативный администратор для анализа выгруженной XML-конфигурации 1С: поиск объектов, структура метаданных, поиск по коду

MCP-серверРасширенный доступ2Звезды репозитория
Российский стек

Индекс кода в SQLite и MCP-инструменты поиска, графа вызовов и метаданных, в том числе для выгрузок 1С из Конфигуратора и EDT

MCP-серверРасширенный доступ162Звезды репозитория
Российский стек

MCP-сервер для Claude Code: полнотекстовый поиск по XML+BSL выгрузкам нескольких конфигураций 1С в локальной SQLite-базе с FTS5

MCP-серверРасширенный доступ
Российский стек

MCP-сервер строит граф метаданных и вызовов по XML- и BSL-выгрузке конфигурации 1С, с опциональным семантическим поиском через внешний эмбеддер и Qdrant

MCP-серверРасширенный доступ4Звезды репозитория
Российский стек

Локальный MCP-сервер для семантического поиска по выгруженной конфигурации 1С с выбором модели эмбеддингов и векторной БД

MCP-серверРасширенный доступ11Звезды репозитория
Российский стек

Локальный MCP-сервер на OneScript для поиска по выгрузке конфигурации 1С прямо из Cursor

MCP-серверРасширенный доступ18Звезды репозитория

Коротко о README

README объясняет, что проект хранит индекс, а не саму конфигурацию, перечисляет таблицы SQLite и модули-индексаторы, показывает команды docker compose для запуска mcp-сервера и раздельной индексации структуры, кода и документации, дает пример конфигурации MCP-клиента через docker compose run и через прямой запуск python3 mcp/server.py, и описывает форматы, которые понимают индексаторы кода и документации.

Бейдж для README

Сообщить о проблеме