1C Context MCP
MCP-сервер, который распаковывает справку 1С из .hbk, индексирует ее в Qdrant и отдает агенту поиск по API, сниппетам и стандартам
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Читает и индексирует справку и метаданные конфигурации, не пишет в базу 1С
- Индекс и выгрузки метаданных остаются в вашей инфраструктуре Docker
Установка
Ручная установка
make quick-start-prebuiltСкачивает готовый публичный индекс Qdrant/BM25 и поднимает MCP на http://localhost:8050/mcp без локальной .hbk-справки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект разбирает файл справки платформы 1С в формате .hbk на структурированный JSONL, строит по нему векторный индекс в Qdrant и поднимает MCP-сервер для поиска по API, сниппетам кода, стандартам разработки и метаданным конфигурации. Состоит из нескольких сервисов в Docker Compose: mcp отдает MCP по HTTP, qdrant хранит индексы, redis держит кеш индексации, а ingest-worker выполняет сборку индекса и периодический watchdog по расписанию. Можно поднять готовый публичный индекс без локальной справки 1С командой make quick-start-prebuilt, либо собрать свой индекс из своего .hbk и выгрузки метаданных конфигурации.
Для кого. Для 1С-разработчиков, которым Cursor или другой агент должен подсказывать API платформы, готовые сниппеты и стандарты прямо по контексту конфигурации.
Подходит, если
- Нужен быстрый поиск по справке платформы 1С прямо в агенте без переключения на веб-справку
- Есть своя .hbk-справка и метаданные конфигурации, которые стоит проиндексировать
- Нужен MCP по streamable HTTP с готовыми примерами конфигурации для Cursor
Не подходит, если
- Не готовы поднимать Docker Compose из нескольких сервисов ради MCP-сервера
- Нет своей .hbk-справки и публичный демо-индекс не подходит по данным (сборка из закрытых конфигураций NDA запрещена автором)
- Нужен легковесный поиск без Qdrant и Redis
Пример запроса к агенту
Найди в справке 1С сигнатуру метода для длительных операций и покажи готовый сниппет вызоваОграничения
Полноценная работа требует Docker и несколько сервисов: mcp, qdrant, redis, ingest-worker. Публичный демо-индекс на Mail.ru Cloud предназначен только для ознакомления, а не для боевой работы. Для своего индекса нужна .hbk-справка платформы 1С и выгрузка метаданных обработкой tools/1c/MetadataExport.epf. Проект активно меняется, лицензия не читается автоматически через GitHub API.
Как отключить. Остановите стек командой docker compose down и удалите сервер из настроек MCP-клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| HOST_HELP_SOURCE_BASE | Путь к локальной .hbk-справке платформы 1С для построения своего индекса |
Проверка безопасности
- Читает и индексирует справку и метаданные конфигурации, не пишет в базу 1С
- Индекс и выгрузки метаданных остаются в вашей инфраструктуре Docker
Коротко о README
README на русском и английском описывает пайплайн из четырех сервисов и два пути старта: быстрый с готовым публичным индексом или полный с локальной справкой 1С. Показаны команды make для запуска, индексации и переиндексации с очисткой, ссылка на streamable HTTP endpoint и пример конфигурации для Cursor. В репозитории есть отдельная папка docs/cursor-examples с готовыми SKILL.md и правилами для Cursor под разные сценарии работы с этим MCP.
Частые вопросы
Обязательно ли строить свой индекс?
Нет, make quick-start-prebuilt скачивает и восстанавливает публичный демо-индекс без локальной .hbk-справки.
Как часто обновляется индекс при своей сборке?
watchdog проверяется при старте и каждые 10 минут, полный ingest идет раз в сутки в 3:00, либо запускается вручную make ingest.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything