MCP-справочник синтаксиса 1С 8.3
1C Syntax Helper MCP (mcp-1c-helper)
Read-only MCP-сервер ищет по индексу справки платформы 1С:Предприятие 8.3 в Elasticsearch и отдает результат агенту гибридным поиском BM25 плюс эмбеддинги
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Сервер явно read-only и только ищет по индексу справки, ничего не пишет
- MCP-эндпоинт публикуется без встроенной аутентификации, доступ стоит ограничивать сетью
Установка
Ручная установка
cp .env.example .env
docker compose up -d --buildЗапуск сервера, Elasticsearch адресуется отдельно через ELASTICSEARCH_URL.
Проверка безопасности
Как мы проверяемНизкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
- Сервер явно read-only и только ищет по индексу справки, ничего не пишет
- MCP-эндпоинт публикуется без встроенной аутентификации, доступ стоит ограничивать сетью
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер парсит файл справки платформы .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-серверыНабор скиллов, который задает агенту процесс разработки: уточнение задачи, план, 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 описывает состав проекта (сервер FastMCP, парсер .hbk и индексатор, поиск, модели, конфиг), окружение с внешним Elasticsearch и опциональным сервисом эмбеддингов, гибридный поиск через RRF с ориентировочными метриками recall, запуск через docker compose и проверку tools/list, полный список из пяти MCP-инструментов, команды индексации .hbk с флагом --reindex, построение отдельного семантического индекса без изменения исходного и пример подключения к opencode как удаленному серверу.