Представляю комплексное решение для интеграции AI-ассистентов (Cursor, Claude Code, Windsurf и др.) с конфигурациями 1С:Предприятие через MCP (Model Context Protocol). Система обеспечивает семантический поиск по коду, метаданным и документации платформы 1С, позволяя AI-ассистентам работать с реальной конфигурацией как с полноценным контекстом.

В отличие от других решений, которые работают только с файлами, это решение использует векторную базу данных Qdrant для семантического поиска по всей конфигурации, включая обработку расширений, анализ зависимостей и поиск по синтаксису платформы.

Версия 2.0: что нового

Обновление по итогам ваших комментариев к первой версии. Всё проверено на реальной конфигурации (713 объектов, ~1 100 модулей, ~20 тыс. процедур) и платформе 8.3.27.2214 — как с GPU, так и без.

• Запуск в одну команду: start.bat / start.sh сами определяют видеокарту; без NVIDIA GPU всё работает на CPU. Исправлены падение сборки mcp-server и первого запуска.
• Проверка кода агентом: новый инструмент bslcheck_code — BSL Language Server 0.29.0 + проверки по стандартам. Агент сам исправляет замечания. Раньше проверка кода фактически не работала.
• Стандарты команды: get_dev_standards, ресурс standards://, промпт develop_1c и папка standards/ для своих правил.
• Новые инструменты по метаданным: list_metadata_objects, find_object_references (где используется объект), поиск индексируемых полей search_by_structure(indexed=True).
• Точнее парсер: признаки полей (индексирование, проверка заполнения, ведущее, основной отбор), определяемые типы ОпределяемыйТип.X вместо «Неопределено», корректные вызовы процедур.
• Loader: больше не теряет модули форм (было 801 из 1 083), новый экран изменений с фильтрами и выгрузкой в CSV, инкрементальное обновление видит любые изменения метаданных.
• Эмбеддинги: модели Qwen3-Embedding и подключение OpenAI-совместимого API (OpenAI, Ollama, LM Studio, vLLM).
• Синтакс-помощник платформы 8.3.27.2214 в комплекте (1 654 объекта), загрузка в несколько раз быстрее, у методов появились параметры.
• Документация: подключение к Cursor, Claude Code, n8n; запуск без GPU; таблица моделей; сравнение с другими MCP для 1С; FAQ.

Полный список изменений — в конце статьи и в файле CHANGELOG.md в архиве.

Архитектура системы

AI-ассистент (Cursor / Claude Code / Windsurf)
        |
        | MCP (HTTP JSON-RPC 2.0, порт 9000)
        v
  MCP 1C RAG Server
        |
        v
  Qdrant (векторная БД, 5 коллекций)
        |
        v
  Embedding Service (GPU ускорение)
        |
        v
  Конфигурация 1С (метаданные + BSL-код)

1 1c_objects_meta — Метаданные объектов

Мультивекторный поиск по 5 векторам:

• object_name — имя объекта
• friendly_name — синоним
• description — описание
• structure — структура объекта (реквизиты, ТЧ)
• relationships — связи с другими объектами

2 1c_modules_full — Метаданные модулей

Хранит информацию о модулях объектов:

• Тип модуля (МодульОбъекта, МодульФормы и т.д.)
• Список процедур и функций
• Количество строк кода
• Экспортные методы

Важно: Полный код модуля восстанавливается из коллекции 1c_procedures.

3 1c_code_chunks — Чанки кода

Фрагменты кода для детального поиска:

• Код чанка
• Номера строк (start_line, end_line)
• Список процедур/функций в чанке
• Индекс чанка в модуле

4 1c_procedures — Процедуры и функции

Ключевая коллекция для быстрого поиска:

• Полный код процедуры/функции
• Сигнатура и параметры
• Метаданные (экспорт, модуль, строки)
• Список вызовов (calls_to)

Преимущества: Прямой доступ к коду процедуры, быстрый поиск (5-10 раз быстрее чанков), экономия места (50-60%).

5 1c_syntax_help — Синтакс-помощник

Документация по синтаксису платформы 1С:

• Глобальные функции (~350)
• Методы объектов (~1 000–7 000)
• Свойства объектов (~1 000–10 000)

cd MCP 1C Server
docker-compose up -d

Доступные сервисы:

• Qdrant: http://localhost:6333/dashboard
• Embedding Service: http://localhost:5000
• Loader: http://localhost:8501
• MCP Server: http://localhost:9000
• Syntax Loader: http://localhost:8502

Выгрузите конфигурацию и расширения из 1С:Предприятие в архив или файлы.

# Windows
parser\start_parser.bat

# Linux/Mac
./parser/start_parser.sh

Откроется браузер на http://localhost:8504. Поместите конфигурацию в parser/in_conf/ и запустите парсинг.

Откройте Loader: http://localhost:8501. Загрузите ZIP архив из parser/out_conf/parsed_<имя_конфигурации>/ (рекомендуется merged.zip для конфигураций с расширениями).

Откройте Syntax Loader: http://localhost:8502. Загрузите готовый structure.json (или создайте его через CLI из .hbk файла).

Создайте файл .cursor/mcp.json:

{
  "servers": {
    "1c-rag": {
      "url": "http://localhost:9000/mcp",
      "headers": {}
    }
  }
}

Пример 1: Поиск объекта

Пользователь: "Найди справочник номенклатуры"

Пример 2: Поиск процедуры

Пользователь: "Найди процедуру печати документа заказ клиента"

Пример 3: Анализ зависимостей

Пользователь: "Покажи что вызывает процедура ПриЗаписи в справочнике Номенклатура"

Пример 4: Поиск синтаксиса

Пользователь: "Как получить длину строки в 1С?"

Пример 5: Работа с документом

Пользователь: "Добавь в документ заказ клиента проверку на заполнение номенклатуры. Создавать заказ можно только с видом номенклатуры Товар"

Пример 6: Проверка кода агентом новое

Агент пишет код, вызывает bslcheck_code и получает замечания:

# Проверка кода BSL
Замечаний: 2 (b88;A039; Warning: 2)

b88;A039; 2:18 [std:GetObjectForAttribute] Объект читается целиком ради одного реквизита.
   Используйте ОбщегоНазначения.ЗначениеРеквизитаОбъекта(Ссылка, "Реквизит") ...
    > Вид = Номенклатура.ПолучитьОбъект().ВидНоменклатуры;
b88;A039; 5:5 [CreateQueryInCycle] Выполнение запроса в цикле
    > Результат = Запрос.Выполнить();

После этого агент сам исправляет код и повторяет проверку.

Пример 7: Индексы регистров новое

Пользователь: "Проанализируй количество проиндексированных полей в регистрах сведений, выведи топ 5"

Агент вызывает search_by_structure(object_type="РегистрСведений", indexed=True) и получает регистры с перечнем индексируемых измерений и реквизитов.

Пример 8: Анализ влияния изменений новое

Пользователь: "Где используется справочник ВидыЦен?"

Агент вызывает find_object_references("Справочник", "ВидыЦен") и получает два списка: где объект встречается в метаданных (типы реквизитов, измерений, владельцы) и где к нему обращается код (объект, модуль, процедура).

🎯 Семантический поиск

Поиск по смыслу, а не только по ключевым словам. AI понимает контекст запроса и находит релевантные результаты даже при неточных формулировках.

b89; Оптимизация производительности

• GPU ускорение для генерации эмбеддингов
• LRU кэш для повторяющихся текстов
• Мультивекторный поиск для улучшенной точности
• Оптимизация памяти (экономия 50-60%)
• Прямой поиск процедур (5-10 раз быстрее)

🔄 Инкрементальное обновление

При повторной загрузке обновляются только изменённые объекты, что ускоряет процесс в 10-20 раз для небольших изменений.

📦 Обработка расширений

Интеллектуальное объединение основной конфигурации с расширениями, включая обработку аннотаций:

• &Перед — код вставляется в начало процедуры
• &После — код вставляется в конец процедуры
• &Вместо — тело процедуры полностью заменяется
• &ИзменениеИКонтроль — замена с обработкой #Вставка/#Удаление