Семантический поиск по справке 1С
1c-sntx-sem
MCP-сервер для Cursor и Claude Desktop с гибридным поиском embeddings и BM25 по справке платформы 1С, языку запросов и Библиотеке стандартных подсистем
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает справку платформы и XML-выгрузку БСП, не подключается к боевой базе
- Может отправлять текст запроса во внешний API эмбеддингов, если выбран не локальный провайдер
Установка
Ручная установка
pip install -e ".[embeddings]"Установка с локальной моделью эмбеддингов E5, без extras работает только вариант с внешним OpenAI-совместимым API.
Проверка безопасности
Как мы проверяемНизкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
- Только читает справку платформы и XML-выгрузку БСП, не подключается к боевой базе
- Может отправлять текст запроса во внешний API эмбеддингов, если выбран не локальный провайдер
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер строит поисковый индекс по справке платформы 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.
Похожие
MCP-серверыНабор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Коротко о README
README дает быстрый старт: установка с extras embeddings, копирование конфига, команда ingest для сборки индекса из платформы, ingest-bsp для БСП, scan-examples для примеров из локальных конфигураций. Описаны HTTP API и веб-UI, Docker-режим с разделением API и MCP, настройка провайдера эмбеддингов на sentence_transformers, OpenAI-совместимый API или Ollama, а также архитектурная документация и журнал решений.