MCP гибридного поиска по синтакс-помощнику 1С

BSL syntax-help MCP

Docker-сервисы с гибридным поиском (FTS5 плюс эмбеддинги) по синтакс-помощнику платформы 1С, выгружаемому из 1C:EDT плагином на Tycho

  • 2 ★ репозитория
  • Последний коммит
  • AGPL-3.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Поднимает Docker-сервисы поиска по синтакс-помощнику и сервис эмбеддингов на GPU
  • MCP-инструменты только ищут по справке, выгрузка из EDT защищена отдельным токеном
Все причины и проверки
Российский стек

malikov-pro/bsl-syntax-help-mcp

Установка

Работает в

Ручная установка

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

MCP-серверРасширенный доступ3Звезды репозитория
Российский стек

MCP-сервер для Cursor и Claude Desktop с гибридным поиском embeddings и BM25 по справке платформы 1С, языку запросов и Библиотеке стандартных подсистем

MCP-серверРасширенный доступ7Звезды репозитория

MCP-справочник синтаксиса 1С 8.3

1C Syntax Helper MCP (mcp-1c-helper)

Российский стек

Read-only MCP-сервер ищет по индексу справки платформы 1С:Предприятие 8.3 в Elasticsearch и отдает результат агенту гибридным поиском BM25 плюс эмбеддинги

MCP-серверРасширенный доступ5Звезды репозитория
Российский стек

MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor

MCP-серверШирокий доступ31Звезды репозитория
Российский стек

MCP-сервер в Docker для поиска по выгрузке 1С: структурный индекс, граф вызовов и семантический поиск по коду

MCP-серверРасширенный доступ79Звезды репозитория
Российский стек

Docker-сервис, который индексирует JSON-выгрузку метаданных конфигураций 1С и дает агенту быстрый поиск объектов по имени и синониму

MCP-серверРасширенный доступ9Звезды репозитория

Коротко о README

README описывает состав из двух Docker-сервисов и плагина для EDT, порты только на loopback, ручной ingest через curl с токеном, рецепт замены модели эмбеддингов на BAAI/bge-m3, подробный перенос SQLite-корпуса между машинами с чекпоинтом WAL, установку плагина EDT с сайта обновлений на GitHub Pages и подключение в Cursor с Bearer-токеном.

Бейдж для README

Сообщить о проблеме