MCP-сервер справки платформы 1С
Onec Platform Help MCP Server
MCP и REST сервер с гибридным поиском (BM25 плюс семантика) по официальной справке платформы 1С:Предприятие
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только индексирует и отдает текст справки платформы для чтения
- Не подключается к базе 1С и не выполняет код
Установка
Ручная установка
git clone https://github.com/rzateev/onec-help-mcp.git && cd onec-help-mcp && docker compose up -dПосле копирования файлов shcntx_ru.hbk и shcntx_root.hbk в data/help1c/<версия>.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер парсит файлы справки платформы (shcntx_ru.hbk и shcntx_root.hbk), которые нужно скопировать из установки 1С, и строит индекс в Qdrant с использованием собственного embedding-сервиса. Агенту доступны пять инструментов: поиск по всей справке естественными запросами, точный поиск API-элементов, получение полной карточки элемента с сигнатурой и примерами, список методов и свойств типа, и управление версиями (индексация, список проиндексированных версий). Поддерживает несколько версий платформы одновременно, каждая хранится отдельной коллекцией. Весь стек (сам сервер, embedding-сервис и Qdrant) поднимается одной командой docker compose up, внешних облачных зависимостей не требует. Есть и REST API на том же порту для использования без MCP-сессии, например из скриптов или Claude Code skills.
Для кого. Для 1С-разработчиков в Cursor или Claude Desktop, которые хотят получать точные ответы из справки платформы прямо в IDE, без переключения в браузер.
Подходит, если
- Нужен точный поиск сигнатуры метода или свойства платформы 1С по имени
- Нужен поиск по смыслу вопроса, а не только по точному совпадению
- Есть Docker и файлы справки из установленной платформы, готовы один раз проиндексировать нужную версию
Не подходит, если
- Нет Docker или нельзя поднимать три контейнера (сервер, embedding, Qdrant)
- Нет доступа к файлам shcntx_ru.hbk и shcntx_root.hbk из установки платформы
- Нужна справка не по платформе, а по конкретной прикладной конфигурации
Пример запроса к агенту
Найди в справке 1С метод HTTPСоединение.ОтправитьДляОбработки и покажи его параметрыОграничения
В README указаны противоречивые сведения о лицензии: бейдж в начале файла говорит Non-Commercial, а раздел в конце указывает MIT License с авторством Романа Затеева; ориентироваться стоит на файл LICENSE в репозитории. Первая индексация версии занимает 5-15 минут на CPU или 2-5 минут на GPU. Файлы справки нужно копировать вручную из установки платформы, автоматической загрузки нет.
Как отключить. Остановите стек командой docker compose down и удалите сервер onec-platform-help из mcp.json клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
Проверка безопасности
- Только индексирует и отдает текст справки платформы для чтения
- Не подключается к базе 1С и не выполняет код
Коротко о README
README описывает гибридный поиск (BM25 плюс семантика), установку за три шага (клонирование, копирование файлов справки, docker compose up), настройку Cursor через mcp.json, таблицу из пяти MCP-инструментов, примеры REST-запросов через curl, диаграмму архитектуры с Qdrant и embedding-сервисом, раздел частых проблем и ссылки на подробную документацию по инструментам, REST API, развертыванию и архитектуре.
Частые вопросы
Нужен ли внешний сервис для эмбеддингов?
Нет, embedding-сервис входит в docker-compose стек и работает локально в режиме CPU или GPU.
Можно использовать без MCP?
Да, все инструменты доступны через REST API на том же порту, например для скриптов автоматизации.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов