Семантический поиск по справке 1С
1c-sntx-sem
MCP-сервер для Cursor и Claude Desktop с гибридным поиском embeddings и BM25 по справке платформы 1С, языку запросов и Библиотеке стандартных подсистем
- 7 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Python-сервер с гибридным поиском по справке 1С и XML-выгрузке БСП
- При первом запуске качает модель E5, с внешним провайдером эмбеддингов отправляет ему текст запросов
Установка
- Работает в
- Сервисы
Ручная установка
pip install -e ".[embeddings]"Установка с локальной моделью эмбеддингов E5, без extras работает только вариант с внешним OpenAI-совместимым API.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Python-сервер с гибридным поиском по справке 1С и XML-выгрузке БСП
- При первом запуске качает модель E5, с внешним провайдером эмбеддингов отправляет ему текст запросов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер строит поисковый индекс по справке платформы 1С (BSL и язык запросов SDBL) и по экспортным методам общих модулей Библиотеки стандартных подсистем (БСП), выгруженным в XML. Поиск гибридный: embeddings плюс BM25 с RRF-объединением, эмбеддинги по умолчанию считаются локально моделью E5, есть варианты через OpenAI-совместимое API и Ollama. Каждый пользователь собирает базу справки локально из своей лицензированной платформы командой ingest, база в репозиторий не входит. Есть HTTP API с веб-интерфейсом поиска в браузере и Docker-вариант, где API работает в контейнере, а тонкий MCP-клиент на хосте.
Для кого. Для 1С-разработчиков на Cursor или Claude Desktop, которым нужен смысловой, а не только текстовый поиск по встроенной справке платформы и БСП.
Подходит, если
- Нужен поиск по справке платформы 1С по смыслу вопроса, а не точному совпадению термина
- Работаете с Библиотекой стандартных подсистем и нужны примеры экспортных методов
- Готовы собрать индекс локально из своей лицензированной платформы
Не подходит, если
- Нет установленной лицензионной платформы 1С для сборки индекса
- Docker-развертывание с 8 ГБ+ RAM для IVF-индекса недоступно, а точность без него ниже
Пример запроса к агенту
Найди в справке 1С, как работает левое соединение в языке запросов, и покажи пример из БСПMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
SNTX_SEM_CONFIG- Путь к config.yaml для локального in-process запуска.
SNTX_SEM_API_URL- Адрес API при тонком MCP-клиенте поверх Docker-контейнера.
Ограничения
База справки не входит в репозиторий, каждый пользователь собирает ее сам из своей платформы, это занимает 5-15 минут на CPU. Локальная модель эмбеддингов E5 весит около 120 МБ и скачивается при первом запуске. Rebuild индекса с IVF в Docker требует 8 ГБ и больше RAM у Docker Desktop, без этого поиск идет без ANN.
Как отключить. Удалите запись 1c-syntax-sem из mcp.json клиента и остановите контейнеры docker compose down, если использовался Docker.
Частые вопросы
Нужен ли торч на хосте при работе через Docker?
Нет, для Docker-варианта есть mcp.json.docker.example без torch, тяжелые вычисления остаются в контейнере с API.
Индексируется ли БСП?
Да, отдельным доменом bsp: экспортные методы из областей ПрограммныйИнтерфейс в общих модулях, выгруженных в XML.
Обсуждение
Вопросов и отзывов пока нет.
Семантический поиск по коду 1С
1C Code Search MCP
Локальный MCP-сервер для семантического поиска по выгруженной конфигурации 1С с выбором модели эмбеддингов и векторной БД
Read-only MCP-сервис гибридного поиска по коду 1С BSL: BM25 плюс векторный поиск, дедупликация и reranking
MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor
MCP-сервер в Docker для поиска по выгрузке 1С: структурный индекс, граф вызовов и семантический поиск по коду
MCP-сервер графа конфигурации 1С
1C Configuration MCP Server
MCP-сервер строит граф метаданных и вызовов по XML- и BSL-выгрузке конфигурации 1С, с опциональным семантическим поиском через внешний эмбеддер и Qdrant
Локальный MCP-сервер на OneScript для поиска по выгрузке конфигурации 1С прямо из Cursor
Коротко о README
README дает быстрый старт: установка с extras embeddings, копирование конфига, команда ingest для сборки индекса из платформы, ingest-bsp для БСП, scan-examples для примеров из локальных конфигураций. Описаны HTTP API и веб-UI, Docker-режим с разделением API и MCP, настройка провайдера эмбеддингов на sentence_transformers, OpenAI-совместимый API или Ollama, а также архитектурная документация и журнал решений.