MCP гибридного поиска по синтакс-помощнику 1С
BSL syntax-help MCP
Docker-сервисы с гибридным поиском (FTS5 плюс эмбеддинги) по синтакс-помощнику платформы 1С, выгружаемому из 1C:EDT плагином на Tycho
- 2 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Поднимает Docker-сервисы поиска по синтакс-помощнику и сервис эмбеддингов на GPU
- MCP-инструменты только ищут по справке, выгрузка из EDT защищена отдельным токеном
Установка
- Работает в
- Сервисы
Ручная установка
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-сервисы поиска по синтакс-помощнику и сервис эмбеддингов на GPU
- MCP-инструменты только ищут по справке, выгрузка из EDT защищена отдельным токеном
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из двух 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: имена инструментов пересекаются, вместе оба не запускать
Пример запроса к агенту
Найди метод для поиска элемента в массиве по значению и покажи его синтаксисMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
INGEST_TOKENобязательная, секрет- Токен для выгрузки данных из плагина EDT и административных операций.
MCP_TOKENобязательная, секрет- Токен доступа к MCP-эндпоинту.
Ограничения
Первый запуск GPU-сервиса требует сборки образа CUDA 12.6 и загрузки около 13 ГБ весов, RTX 3090 или сравнимая видеокарта нужна для комфортной работы. Индексируемый корпус не хранится в git, живет как файлы SQLite на хосте и требует ручного переноса между машинами. Не запускать рядом с HelpSearchServer из-за пересечения имен инструментов.
Как отключить. Останови оба стека командами docker compose down в docker/giga и docker/mcp и удали сервер из mcp.json Cursor.
Частые вопросы
Что если GPU-сервис недоступен?
MCP переходит в состояние degraded и продолжает искать через FTS, гибридный поиск возвращается, когда Giga снова здоров.
Можно ли сменить модель эмбеддингов?
Да, README описывает переход на BAAI/bge-m3 с правкой размерности EXPECTED_EMBED_DIM и обязательной полной переиндексацией.
Обсуждение
Вопросов и отзывов пока нет.
Read-only MCP-сервис гибридного поиска по коду 1С BSL: BM25 плюс векторный поиск, дедупликация и reranking
Семантический поиск по справке 1С
1c-sntx-sem
MCP-сервер для Cursor и Claude Desktop с гибридным поиском embeddings и BM25 по справке платформы 1С, языку запросов и Библиотеке стандартных подсистем
MCP-справочник синтаксиса 1С 8.3
1C Syntax Helper MCP (mcp-1c-helper)
Read-only MCP-сервер ищет по индексу справки платформы 1С:Предприятие 8.3 в Elasticsearch и отдает результат агенту гибридным поиском BM25 плюс эмбеддинги
MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor
MCP-сервер в Docker для поиска по выгрузке 1С: структурный индекс, граф вызовов и семантический поиск по коду
MCP поиска по метаданным 1С
mcp1c_metadata
Docker-сервис, который индексирует JSON-выгрузку метаданных конфигураций 1С и дает агенту быстрый поиск объектов по имени и синониму
Коротко о README
README описывает состав из двух Docker-сервисов и плагина для EDT, порты только на loopback, ручной ingest через curl с токеном, рецепт замены модели эмбеддингов на BAAI/bge-m3, подробный перенос SQLite-корпуса между машинами с чекпоинтом WAL, установку плагина EDT с сайта обновлений на GitHub Pages и подключение в Cursor с Bearer-токеном.