v8help: CLI и MCP по справке 1С с гибридным поиском
v8help
MCP-сервер и CLI для 1С, которые строят полнотекстовый и векторный индекс по .hbk-справке платформы и понимают идентификаторы в PascalCase на русском
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Python-сервер, который извлекает справку 1С и строит индекс SQLite
- Для векторного поиска шлет текст в настроенный эмбеддер: LM Studio, Ollama или Hugging Face
Установка
- Работает в
- Сервисы
Ручная установка
python -m venv .venv && pip install -e .Установка регистрирует два консольных скрипта: v8help и v8help-mcp.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Python-сервер, который извлекает справку 1С и строит индекс SQLite
- Для векторного поиска шлет текст в настроенный эмбеддер: LM Studio, Ollama или Hugging Face
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент извлекает HTML-страницы из контейнера справки платформы 1С, конвертирует их в Markdown с переписыванием внутренних ссылок v8help://... в относительные, строит полнотекстовый индекс SQLite FTS5 с лексическим расширением, которое умеет разбивать идентификаторы вроде СтрНайтиПоРегулярномуВыражению на составляющие слова. Ранжирование учитывает вес поля: совпадение в заголовке или разделе Описание весомее совпадения в теле статьи. Поддержан векторный и гибридный поиск через OpenAI-совместимый API эмбеддингов, длинные статьи режутся на чанки с метаданными соседей. Сборка индекса асинхронная: build возвращает job_id сразу, прогресс отслеживается через build_status, поиск при этом не блокируется.
Для кого. Для 1С-разработчиков, которым нужен точный поиск по справке платформы с пониманием русских идентификаторов в PascalCase и опционально смысловой поиск.
Подходит, если
- Нужен поиск по справке 1С, который правильно разбивает составные русские идентификаторы
- Нужен и CLI для терминала, и MCP-сервер для агента из одной установки
- Есть готовые индексы без установленной платформы: можно взять их из документации, не пересобирая
Не подходит, если
- Нужен только векторный поиск без учета FTS5: инструмент по умолчанию гибридный
- Нет установленной платформы и готового индекса одновременно: без одного из них искать нечего
Пример запроса к агенту
Найди через v8help метод СтрНайтиПоРегулярномуВыражению и покажи параметрыMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Для пересборки индекса нужна установленная платформа 1С:Предприятие с каталогом bin, где лежат .hbk-файлы; для одного поиска достаточно готовой базы. Векторный или гибридный поиск требует настроенного эмбеддера: LM Studio, Ollama или Hugging Face. Docker-вариант описан отдельно с базой на volume и опциональной автозагрузкой индекса.
Как отключить. Удалите запись v8help из конфигурации MCP-клиента и, если нужно, деинсталлируйте консольные скрипты v8help и v8help-mcp.
Частые вопросы
Нужна ли платформа 1С для каждого поиска?
Нет, платформа нужна только для сборки индекса, для поиска достаточно уже собранной базы, есть и готовые индексы без установленной платформы.
Как учитывается заголовок статьи при ранжировании?
Поля title, description и body взвешены 9 к 3 к 1, совпадение в заголовке или описании метода значит больше, чем в теле.
Обсуждение
Вопросов и отзывов пока нет.
MCP-справочник синтаксиса 1С 8.3
1C Syntax Helper MCP (mcp-1c-helper)
Read-only MCP-сервер ищет по индексу справки платформы 1С:Предприятие 8.3 в Elasticsearch и отдает результат агенту гибридным поиском BM25 плюс эмбеддинги
Standalone MCP для справки 1С на Rust
mcp-1c-help
Легкий MCP-сервер на Rust с HTTP/SSE транспортом, который ищет по официальной справке платформы 1С:Предприятие 8.3 через SQLite FTS5
MCP-сервер для Claude Code: полнотекстовый поиск по XML+BSL выгрузкам нескольких конфигураций 1С в локальной SQLite-базе с FTS5
MCP-сервер поиска по синтакс-помощнику платформы 1С: глобальные функции, методы и свойства объектов через Elasticsearch
Локальный read-only набор MCP-серверов для 1С: Rust-индексатор кода, скиллы метаданных, галерея промптов и поиск по справке платформы
Индекс кода в SQLite и MCP-инструменты поиска, графа вызовов и метаданных, в том числе для выгрузок 1С из Конфигуратора и EDT
Коротко о README
README описывает MCP-инструмент и CLI для чтения, индексации и поиска по справке 1С в формате .hbk. Дан быстрый старт с копированием конфига, командами build и search, ссылки на отдельные документы по конфигурации, эмбеддингам, Docker-запуску и разработке. Отдельно указана благодарность за портированный конвертер HTML в Markdown из проекта hbk-to-md.