v8help: CLI и MCP по справке 1С с гибридным поиском
v8help
MCP-сервер и CLI для 1С, которые строят полнотекстовый и векторный индекс по .hbk-справке платформы и понимают идентификаторы в PascalCase на русском
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает локальный файл справки платформы и строит поисковый индекс
- При векторном поиске текст запроса может уходить к настроенному эмбеддеру
Установка
Ручная установка
python -m venv .venv && pip install -e .Установка регистрирует два консольных скрипта: v8help и v8help-mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент извлекает HTML-страницы из контейнера справки платформы 1С, конвертирует их в Markdown с переписыванием внутренних ссылок v8help://... в относительные, строит полнотекстовый индекс SQLite FTS5 с лексическим расширением, которое умеет разбивать идентификаторы вроде СтрНайтиПоРегулярномуВыражению на составляющие слова. Ранжирование учитывает вес поля: совпадение в заголовке или разделе Описание весомее совпадения в теле статьи. Поддержан векторный и гибридный поиск через OpenAI-совместимый API эмбеддингов, длинные статьи режутся на чанки с метаданными соседей. Сборка индекса асинхронная: build возвращает job_id сразу, прогресс отслеживается через build_status, поиск при этом не блокируется.
Для кого. Для 1С-разработчиков, которым нужен точный поиск по справке платформы с пониманием русских идентификаторов в PascalCase и опционально смысловой поиск.
Подходит, если
- Нужен поиск по справке 1С, который правильно разбивает составные русские идентификаторы
- Нужен и CLI для терминала, и MCP-сервер для агента из одной установки
- Есть готовые индексы без установленной платформы: можно взять их из документации, не пересобирая
Не подходит, если
- Нужен только векторный поиск без учета FTS5: инструмент по умолчанию гибридный
- Нет установленной платформы и готового индекса одновременно: без одного из них искать нечего
Пример запроса к агенту
Найди через v8help метод СтрНайтиПоРегулярномуВыражению и покажи параметрыОграничения
Для пересборки индекса нужна установленная платформа 1С:Предприятие с каталогом bin, где лежат .hbk-файлы; для одного поиска достаточно готовой базы. Векторный или гибридный поиск требует настроенного эмбеддера: LM Studio, Ollama или Hugging Face. Docker-вариант описан отдельно с базой на volume и опциональной автозагрузкой индекса.
Как отключить. Удалите запись v8help из конфигурации MCP-клиента и, если нужно, деинсталлируйте консольные скрипты v8help и v8help-mcp.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Проверка безопасности
- Только читает локальный файл справки платформы и строит поисковый индекс
- При векторном поиске текст запроса может уходить к настроенному эмбеддеру
Коротко о README
README описывает MCP-инструмент и CLI для чтения, индексации и поиска по справке 1С в формате .hbk. Дан быстрый старт с копированием конфига, командами build и search, ссылки на отдельные документы по конфигурации, эмбеддингам, Docker-запуску и разработке. Отдельно указана благодарность за портированный конвертер HTML в Markdown из проекта hbk-to-md.
Частые вопросы
Нужна ли платформа 1С для каждого поиска?
Нет, платформа нужна только для сборки индекса, для поиска достаточно уже собранной базы, есть и готовые индексы без установленной платформы.
Как учитывается заголовок статьи при ранжировании?
Поля title, description и body взвешены 9 к 3 к 1, совпадение в заголовке или описании метода значит больше, чем в теле.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything