MCP гибридного поиска по синтакс-помощнику 1С
BSL syntax-help MCP
Docker-сервисы с гибридным поиском (FTS5 плюс эмбеддинги) по синтакс-помощнику платформы 1С, выгружаемому из 1C:EDT плагином на Tycho
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- MCP-инструменты только читают и ищут по справке, выгрузка (ingest) делается отдельным защищенным токеном
Установка
Ручная установка
docker network create syntax-help && docker compose -f docker/giga/docker-compose.yml up -d --build && docker compose -f docker/mcp/docker-compose.yml up -d --buildПоднимает оба сервиса, giga собирается дольше из-за весов модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из двух Docker-сервисов и плагина для 1C:EDT. Плагин выгружает синтакс-помощник платформы из EDT по HTTP в сервис ingest. FastAPI-сервис на CPU хранит карточки в SQLite с FTS5 и sqlite-vec и отдает MCP-инструменты в стиле Comol: docinfo, docsearch, docmembers. Отдельный GPU-сервис считает эмбеддинги моделью Giga-Embeddings-instruct через OpenAI-совместимый API; без него поиск переходит в режим только FTS. Модель эмбеддингов заменяема: в README описан переход на BAAI/bge-m3 с меньшей размерностью и без инструктивного префикса.
Для кого. Для команд 1С-разработчиков на 1C:EDT, у которых есть GPU для локальных эмбеддингов и нужен смысловой, а не только текстовый поиск по синтакс-помощнику.
Подходит, если
- Нужен смысловой поиск по синтакс-помощнику платформы, а не только точное совпадение текста
- Есть 1C:EDT и хочется выгружать справку прямо из среды разработки
- Нужно перенести готовый индекс на другую машину без повторной выгрузки
Не подходит, если
- Нет GPU для контейнера эмбеддингов: первый прогон тянет около 13 ГБ весов модели
- Уже используется HelpSearchServer: имена инструментов пересекаются, вместе оба не запускать
Пример запроса к агенту
Найди метод для поиска элемента в массиве по значению и покажи его синтаксисОграничения
Первый запуск GPU-сервиса требует сборки образа CUDA 12.6 и загрузки около 13 ГБ весов, RTX 3090 или сравнимая видеокарта нужна для комфортной работы. Индексируемый корпус не хранится в git, живет как файлы SQLite на хосте и требует ручного переноса между машинами. Не запускать рядом с HelpSearchServer из-за пересечения имен инструментов.
Как отключить. Останови оба стека командами docker compose down в docker/giga и docker/mcp и удали сервер из mcp.json Cursor.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| INGEST_TOKEN обязательная, секрет | Токен для выгрузки данных из плагина EDT и административных операций. |
| MCP_TOKEN обязательная, секрет | Токен доступа к MCP-эндпоинту. |
Проверка безопасности
- MCP-инструменты только читают и ищут по справке, выгрузка (ingest) делается отдельным защищенным токеном
Коротко о README
README описывает состав из двух Docker-сервисов и плагина для EDT, порты только на loopback, ручной ingest через curl с токеном, рецепт замены модели эмбеддингов на BAAI/bge-m3, подробный перенос SQLite-корпуса между машинами с чекпоинтом WAL, установку плагина EDT с сайта обновлений на GitHub Pages и подключение в Cursor с Bearer-токеном.
Частые вопросы
Что если GPU-сервис недоступен?
MCP переходит в состояние degraded и продолжает искать через FTS, гибридный поиск возвращается, когда Giga снова здоров.
Можно ли сменить модель эмбеддингов?
Да, README описывает переход на BAAI/bge-m3 с правкой размерности EXPECTED_EMBED_DIM и обязательной полной переиндексацией.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything