MCP-сервер с RAG по структуре конфигурации 1С

mcp-1c-v1

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

MCP-серверСредний рискРоссийский стек

fserg/mcp-1c-v1

Установка

chmod +x start.sh && chmod +x stop.sh
./start.sh

Выполняется в клоне репозитория, альтернатива docker-compose up --build.

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

Что делает

Проект состоит из нескольких сервисов. Внешняя обработка выгружает из 1С описание структуры конфигурации в markdown-файлы, веб-загрузчик на Streamlit кладет архив в Qdrant, сервис эмбеддингов строит векторы, а MCP-сервер отвечает агенту на вопросы о метаданных. Поиск идет сразу по двум векторам, имени объекта и синониму, результаты объединяются методом RRF. Через заголовок x-collection-name один сервер обслуживает разные конфигурации.

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

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

  • Нужно найти объект метаданных, не зная точного имени
  • Нужен один сервер структуры для нескольких конфигураций
  • Хотите собрать RAG по 1С на своих мощностях

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

  • Нужен поиск по коду модулей, а не по структуре
  • Нет возможности держать Docker с несколькими сервисами

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

Найди документы, которые отвечают за возврат товаров от покупателя

Ограничения

Индексируется только структура конфигурации, не код. После изменений нужно заново выгрузить и загрузить архив. Проект давно не обновлялся. Нужен Docker Compose, при сборке образов скачиваются зависимости и модель эмбеддингов.

Как отключить. Выполните ./stop.sh или docker-compose down и удалите сервер из настроек клиента.

MCP

Транспорт
http
Авторизация
не нужна
Переменные окружения
Переменные окружения
EMBEDDING_SERVICE_URL
Адрес сервиса эмбеддингов
QDRANT_HOST
Хост Qdrant
QDRANT_PORT
Порт Qdrant
COLLECTION_NAME
Коллекция по умолчанию, 1c_rag

Проверка безопасности

  • Поднимает несколько сетевых сервисов без встроенной аутентификации
  • Хранит описание структуры конфигурации в векторной базе

Коротко о README

README перечисляет сервисы проекта, описывает мультивекторный поиск и запуск всех контейнеров скриптом или через docker-compose. Указаны адреса загрузчика, сервиса эмбеддингов, Qdrant, MCP-сервера и MCP Inspector. Пошагово описан процесс от выгрузки структуры до поиска, приведены конфиги VS Code и Cursor и переменные окружения. Есть видео и статья автора.

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

Почему VS Code Copilot не подключается?

Автор отмечает, что у него Copilot работал только через SSE, поэтому для него указывается адрес /mcp/sse.

Как держать несколько конфигураций?

Загрузите каждую в свою коллекцию Qdrant и укажите ее имя в заголовке x-collection-name в настройках проекта.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний риск136,8 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.