MCP-справочник синтаксиса 1С 8.3
1C Syntax Helper MCP (mcp-1c-helper)
Read-only MCP-сервер ищет по индексу справки платформы 1С:Предприятие 8.3 в Elasticsearch и отдает результат агенту гибридным поиском BM25 плюс эмбеддинги
- 5 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Поднимает в Docker сервер, который ищет по справке 1С в вашем Elasticsearch
- HTTP-эндпоинт без встроенной авторизации, доступ стоит закрыть сетью
Установка
- Работает в
- Сервисы
Ручная установка
cp .env.example .env
docker compose up -d --buildЗапуск сервера, Elasticsearch адресуется отдельно через ELASTICSEARCH_URL.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Поднимает в Docker сервер, который ищет по справке 1С в вашем Elasticsearch
- HTTP-эндпоинт без встроенной авторизации, доступ стоит закрыть сетью
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер парсит файл справки платформы .hbk и индексирует его в Elasticsearch, а затем отдает пять инструментов: поиск по имени, описанию или ключевым словам find_1c_help, краткая и полная справка по элементу синтаксиса, список методов и свойств объекта и поиск с фильтром по контексту global, object или all. find_1c_help работает гибридно: BM25 по тексту плюс kNN по эмбеддингам с объединением результатов через RRF, если задан сервис эмбеддингов, иначе поиск остается чисто лексическим. Отдельный скрипт строит семантический индекс поверх уже готового лексического, не трогая исходный. Индексация .hbk запускается вручную, автоматической индексации при старте нет.
Для кого. Для 1С-разработчиков, у которых уже есть или которые готовы поднять общий Elasticsearch, и которым нужен быстрый read-only поиск по синтаксической справке платформы прямо из агента.
Подходит, если
- Нужен быстрый поиск по синтаксической справке платформы 1С прямо из агента, без открытия синтакс-помощника
- Уже есть Elasticsearch в сети и можно проиндексировать в него .hbk своей версии платформы
- Нужен список методов и свойств конкретного объекта платформы
Не подходит, если
- Нет доступа к внешнему Elasticsearch: сервер сам его не поднимает, только indexится и ищет в уже существующем
- Нужен семантический поиск, а сервис эмбеддингов недоступен: без него find_1c_help работает только лексически
- Нужна справка по прикладной конфигурации, а не по платформе: сервер индексирует именно платформенный .hbk
Пример запроса к агенту
Найди в справке платформы, какие методы есть у объекта ТаблицаЗначений, и покажи краткое описание метода СвернутьMCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
ELASTICSEARCH_URLобязательная- Адрес внешнего Elasticsearch с индексом справки.
EMBEDDING_URL- Адрес сервиса эмбеддингов, пусто значит поиск только лексический.
ELASTICSEARCH_INDEX- Имя индекса, по умолчанию help1c_docs_v2 семантический или help1c_docs прежний лексический.
Ограничения
Elasticsearch это внешний сервис, который нужно поднять и адресовать отдельно, сервер сам его не разворачивает. Семантический поиск на индексе help1c_docs_v2 по замеру автора дает Recall@3 около 46% и Recall@5 около 50%, то есть не гарантирует найти нужный документ в топе. Файл .hbk с платформенной справкой не входит в репозиторий, его нужно извлечь из своей установки платформы, для распаковки нужен 7z. Индексация запускается вручную и без флага --reindex выполняется только если индекс пуст.
Как отключить. Остановите контейнер командой docker compose down и удалите сервер из конфигурации MCP-клиента.
Частые вопросы
Сервер сам поднимает Elasticsearch?
Нет, README прямо указывает Elasticsearch как внешний сервис по адресу ELASTICSEARCH_URL, docker compose поднимает только сам MCP-сервер.
Работает ли поиск без сервиса эмбеддингов?
Да, если EMBEDDING_URL не задан, find_1c_help работает только лексически через BM25, остальные инструменты и так ищут по точному имени.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер поиска по синтакс-помощнику платформы 1С: глобальные функции, методы и свойства объектов через Elasticsearch
MCP-сервер для поиска и проверки синтаксиса 1С, который сам распаковывает справку из установленной платформы при первом запуске
MCP-сервер и CLI для 1С, которые строят полнотекстовый и векторный индекс по .hbk-справке платформы и понимают идентификаторы в PascalCase на русском
MCP-сервер справки платформы 1С
Onec Platform Help MCP Server
MCP и REST сервер с гибридным поиском (BM25 плюс семантика) по официальной справке платформы 1С:Предприятие
MCP-сервер по документации API платформы 1С прямо из файлов справки shcntx_ru.hbk, с keyword, semantic и hybrid поиском
Справка платформы 1С по MCP
mcp-bsl-platform-context
MCP-сервер со справкой синтакс-помощника 1С: поиск функций, типов, методов, свойств и конструкторов из установленной платформы
Коротко о README
README описывает состав проекта (сервер FastMCP, парсер .hbk и индексатор, поиск, модели, конфиг), окружение с внешним Elasticsearch и опциональным сервисом эмбеддингов, гибридный поиск через RRF с ориентировочными метриками recall, запуск через docker compose и проверку tools/list, полный список из пяти MCP-инструментов, команды индексации .hbk с флагом --reindex, построение отдельного семантического индекса без изменения исходного и пример подключения к opencode как удаленному серверу.