Elemctl

Неофициальный CLI, MCP-сервер и Python-библиотека для Console API 1С:Элемента: приложения, сборки и деплой с проверкой применения

CLIВысокий рискРоссийский стек

keyfire/elemctl

Установка

pipx install elemctl

Только CLI, без внешних зависимостей.

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

Что делает

Инструмент управляет приложениями в облаке 1С:Элемент без веб-консоли. Он создает, запускает, останавливает и удаляет приложения, собирает архив .xasm или .xlib из исходников проекта, загружает сборку и применяет ее. После деплоя elemctl проверяет, что сборка действительно применилась: смотрит ошибки задач, версию проекта у приложения и отвечает ли адрес, потому что платформа может молча откатиться. Команда probe проверяет компиляцию во временном приложении, не трогая рабочее. Те же операции доступны агентам через MCP-сервер, а вывод CLI в JSON удобен для CI.

Для кого. Для разработчиков на 1С:Элементе, которые хотят деплоить из терминала, CI или через агента.

Подходит, если

  • Нужно собрать и задеплоить приложение Элемента одной командой
  • Нужно, чтобы агент проверял компиляцию правок, не ломая рабочее приложение
  • Нужен деплой в CI с достоверным кодом возврата

Не подходит, если

  • Разработка ведется на платформе 1С:Предприятие 8, а не на Элементе
  • Нельзя давать агенту права удалять приложения в облаке

Пример запроса к агенту

Проверь компиляцию текущего проекта через probe и, если ошибок нет, задеплой его в приложение

Ограничения

Проект неофициальный и работает только с документированным Console API v2. Нужны Client-Id и Client-Secret из раздела интеграций Console API в панели 1cmycloud. Требуется Python 3.10, для MCP-сервера нужна установка с дополнением mcp. На некоторых конфигурациях платформы приложение, созданное только по идентификатору проекта, получается пустым, автор описывает обходной путь.

Как отключить. Удалите сервер командой claude mcp remove elemctl и пакет через pipx uninstall elemctl или pip uninstall elemctl. Отзовите ключи в панели 1cmycloud.

Проверка безопасности

  • Деплоит сборки, перезапускает и удаляет приложения в облаке 1С:Элемент
  • Хранит секрет Console API

Коротко о README

README на английском и русском описывает возможности: приложения, сборки из исходников, деплой с проверкой, probe, списки пользователей, ветки среды разработки и дампы. Установка через pipx или pip, настройка через переменные окружения или .env, отдельно разобраны сертификаты частного облака и переменные CI. Есть раздел о MCP-сервере и системе плагинов, где одна команда становится и подкомандой CLI, и инструментом MCP. Лицензия MIT.

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

Зачем проверять деплой, если статус Running?

При ошибке применения платформа молча откатывает приложение на прошлую сборку, и статус не меняется. elemctl сверяет версию проекта и ошибки задач, код возврата нулевой только при реальном применении.

Трогает ли probe рабочее приложение?

Нет, компиляция идет во временном приложении, которое потом удаляется. probe намеренно не читает ELEMENT_APP_ID и ELEMENT_PROJECT_ID.

Выбор редакции

MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента

MCP-серверСредний риск80,5 тыс.
Выбор редакции

Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента

MCP-серверВысокий риск32,9 тыс.
Выбор редакции

GitHub Action, который запускает Claude Code в pull requests и issues: отвечает на упоминания, делает ревью и вносит правки

ПлагинВысокий риск8,9 тыс.
Выбор редакции

AI-помощник для Kubernetes: переводит запросы на естественном языке в операции kubectl и работает как MCP-сервер

CLIВысокий риск7,6 тыс.