http1c: фреймворк MCP-серверов для 1С

http1c

Нативный компонент, который поднимает полноценный MCP-сервер внутри 1С: инструменты, ресурсы, промпты пишутся на BSL, а протокол берет на себя DLL

  • 44 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

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

  • Демо-инструмент execute выполняет произвольный код 1С на сервере или тонком клиенте
  • По умолчанию аутентификация не включена, любой, кто достучится до порта, получает доступ ко всем инструментам
Все причины и проверки
Российский стек

ditrixnew/mcp-db-client

Установка

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

build/build-http1c-dll-release.sh

Собирает нативный компонент и упаковывает расширение, требует Visual Studio Build Tools 2019+.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Демо-инструмент execute выполняет произвольный код 1С на сервере или тонком клиенте
  • По умолчанию аутентификация не включена, любой, кто достучится до порта, получает доступ ко всем инструментам

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

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 для проверки создания нового элемента

MCP

Транспорт
sse, http
Авторизация
API-ключ

Ограничения

Сборка нативного компонента возможна только на Windows с MSVC. HTTP-сервер намеренно локальный и слушает только 127.0.0.1. Инструменты execute и evaluate в демо-обработке сами авторы называют мощными возможностями сервера, которые стоит использовать только в доверенном локальном окружении. Полная сборка с семантическим поиском (rcore.dll) требует Rust, а GPU-ускорение через DirectML зависит от системной библиотеки Windows.

Как отключить. Отсоедините компонент в форме обработки http1c.epf (StopListen) или закройте обработку, и удалите сервер из mcp.json клиента.

Частые вопросы

Обязательно ли собирать семантический поиск?

Нет, по умолчанию собирается lite-версия без Rust-ядра, поиск можно добавить отдельно флагом -DRCORE_FASTEMBED=ON.

Нужно ли писать код на C++ для новых инструментов?

Нет, новые инструменты, ресурсы и промпты описываются на BSL и регистрируются в компоненте, транспортный слой трогать не нужно.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Расширение 1С, которое поднимает MCP-сервер прямо внутри клиента 1С:Предприятия и позволяет описывать свои инструменты на BSL

MCP-серверРасширенный доступ71Звезды репозитория
Российский стек

Расширение 1С на основе vladimir-kharin/1c_mcp, которое добавляет выполнение произвольного кода встроенного языка прямо в контексте информационной базы

MCP-серверШирокий доступ5Звезды репозитория
Российский стек

Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL

MCP-серверШирокий доступ573Звезды репозитория
Российский стек

Docker-шлюз с одним адресом вместо нескольких MCP-подключений: данные 1С, навигация по BSL, поиск по ИТС через 1С:Напарник и веб-дашборд

MCP-серверШирокий доступ5Звезды репозитория
Российский стек

Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации

MCP-серверШирокий доступ357Звезды репозитория
Российский стек

Десять MCP-серверов для разработки 1С: справка платформы, точечная выгрузка и загрузка объектов, COM, хранилище, поиск по файлам и BSL Language Server

MCP-серверШирокий доступ1Звезды репозитория

Коротко о README

README подробно описывает архитектуру и разделение ответственности между DLL и 1С, полный список нативных методов и событий ExternalEvent, поддерживаемые методы протокола MCP, справочные инструменты, ресурсы и промпты демо-обработки, настройку Bearer-аутентификации, устройство и мотивацию подсистемы семантического поиска (RAG) на rcore с таблицей проектных решений, различия сборок lite и full, интеграцию с Vanessa Automation через плагин MCPRagSearch, требования к сборке на Windows и известные ограничения.

Бейдж для README

Сообщить о проблеме