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

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

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

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: Работа с документом

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

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

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

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

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

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

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

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

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

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