MCP-сервер с RAG по структуре конфигурации 1С
mcp-1c-v1
Набор контейнеров: выгрузка структуры конфигурации 1С, векторная база Qdrant и MCP-сервер, который ищет объекты по смыслу
Установка
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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything