http1c: фреймворк MCP-серверов для 1С
http1c
Нативный компонент, который поднимает полноценный MCP-сервер внутри 1С: инструменты, ресурсы, промпты пишутся на BSL, а протокол берет на себя DLL
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Демо-инструмент execute выполняет произвольный код 1С на сервере или тонком клиенте
- По умолчанию аутентификация не включена, любой, кто достучится до порта, получает доступ ко всем инструментам
Установка
Ручная установка
build/build-http1c-dll-release.shСобирает нативный компонент и упаковывает расширение, требует Visual Studio Build Tools 2019+.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
http1c разделяет ответственность на два слоя: нативный компонент (DLL) обрабатывает транспорт MCP по Streamable HTTP и SSE, управление сессиями, аутентификацию по Bearer-токену, пагинацию и уведомления, а сторона 1С на BSL описывает конкретные инструменты, ресурсы и промпты и обрабатывает вызовы через ExternalEvent. В комплекте демонстрационная внешняя обработка с примерами инструментов execute (выполнение произвольного кода), evaluate, query, openForm и getStatus. Опционально доступен встроенный семантический поиск (RAG) на движке rcore на Rust с гибридным поиском (dense плюс keyword), который индексирует любой контент 1С без внешних сервисов, и готовая интеграция MCPRagSearch для Vanessa Automation, отдающая весь MCP-контракт VA плюс поиск по каталогу шагов и базе знаний.
Для кого. Для 1С-разработчиков, которые хотят опубликовать бизнес-логику своей конфигурации агентам по MCP, не разбираясь в HTTP, JSON-RPC и SSE самостоятельно.
Подходит, если
- Нужен MCP-сервер поверх своей конфигурации 1С с произвольными инструментами на BSL
- Нужен семантический поиск по документации, коду, описаниям справочников или логам без внешнего векторного хранилища
- Пишете тесты на Vanessa Automation и хотите, чтобы агент опирался на реальный каталог шагов через поиск, а не выдумывал их
Не подходит, если
- Нет Windows и Visual Studio Build Tools для сборки нативного компонента
- Нужна готовая функциональность: проект это фреймворк, в котором инструменты описываются самостоятельно
- Не готовы явно ограничивать инструмент execute, который выполняет произвольный код 1С
Пример запроса к агенту
Открой форму справочника Номенклатура и найди по смыслу шаги Vanessa для проверки создания нового элементаОграничения
Сборка нативного компонента возможна только на Windows с MSVC. HTTP-сервер намеренно локальный и слушает только 127.0.0.1. Инструменты execute и evaluate в демо-обработке сами авторы называют мощными возможностями сервера, которые стоит использовать только в доверенном локальном окружении. Полная сборка с семантическим поиском (rcore.dll) требует Rust, а GPU-ускорение через DirectML зависит от системной библиотеки Windows.
Как отключить. Отсоедините компонент в форме обработки http1c.epf (StopListen) или закройте обработку, и удалите сервер из mcp.json клиента.
MCP
- Транспорт
- sse, http
- Авторизация
- API-ключ
Проверка безопасности
- Демо-инструмент execute выполняет произвольный код 1С на сервере или тонком клиенте
- По умолчанию аутентификация не включена, любой, кто достучится до порта, получает доступ ко всем инструментам
Коротко о README
README подробно описывает архитектуру и разделение ответственности между DLL и 1С, полный список нативных методов и событий ExternalEvent, поддерживаемые методы протокола MCP, справочные инструменты, ресурсы и промпты демо-обработки, настройку Bearer-аутентификации, устройство и мотивацию подсистемы семантического поиска (RAG) на rcore с таблицей проектных решений, различия сборок lite и full, интеграцию с Vanessa Automation через плагин MCPRagSearch, требования к сборке на Windows и известные ограничения.
Частые вопросы
Обязательно ли собирать семантический поиск?
Нет, по умолчанию собирается lite-версия без Rust-ядра, поиск можно добавить отдельно флагом -DRCORE_FASTEMBED=ON.
Нужно ли писать код на C++ для новых инструментов?
Нет, новые инструменты, ресурсы и промпты описываются на BSL и регистрируются в компоненте, транспортный слой трогать не нужно.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything