MCP-сервер справки платформы 1С

Onec Platform Help MCP Server

MCP и REST сервер с гибридным поиском (BM25 плюс семантика) по официальной справке платформы 1С:Предприятие

MCP-сервер

Низкий риск

Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.

Почему такой уровень

  • Только индексирует и отдает текст справки платформы для чтения
  • Не подключается к базе 1С и не выполняет код
Все причины и проверки
Российский стек

rzateev/onec-help-mcp

Установка

Ручная установка

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 для модели

MCP-серверСредний рискБез VPN187,4 тыс.Звезды репозитория
Выбор редакции

Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills

СкиллСредний риск178,8 тыс.Звезды репозитория
Выбор редакции

Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями

СкиллСредний риск56,8 тыс.Звезды репозитория
Выбор редакции

Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов

СкиллСредний рискБез VPN42,6 тыс.Звезды репозитория
Foxx AIMCP-сервер справки платформы 1С

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.