1C AI Workbench
Локальный read-only набор MCP-серверов для 1С: Rust-индексатор кода, скиллы метаданных, галерея промптов и поиск по справке платформы
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Дефолтный режим read-only, выгрузка зеркалируется и не изменяется индексацией
- Единственный путь записи, 1c-ibcmd, выключен по умолчанию и требует двойного явного подтверждения
Установка
Ручная установка
.\scripts\setup.ps1
.\scripts\04_index_1c_dump.ps1 -DumpRoot "C:\1c-ai-client\dump" -Force
.\scripts\06_healthcheck.ps1Установка зависимостей, индексация выгрузки и проверка готовности после скачивания подписанного релиза.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Workbench зеркалирует XML-выгрузку конфигурации 1С в read-only копию, индексирует BSL-код и метаданные Rust-бинарником bsl-indexer и отдает результат через несколько MCP-серверов: 1c-code-index (основной индекс кода на SQLite), 1c-skills (16 read-only инструментов вроде meta_info, form_info, skd_info, role_info, cf_info), 1c-prompt-gallery (промпты explain-module, find-object, review-bsl, trace-flow как вызываемые инструменты) и 1c-help-index (локальный поиск по .hbk справке платформы через FTS5). Экспериментальный 1c-ibcmd для live-операций с утилитой ibcmd выключен по умолчанию и требует явных IBCMD_ALLOW_WRITE=1 и confirm_replace=true. Заявленный контракт ответа требует от ИИ короткий вывод, имя и тип объекта, путь к файлу, модуль или процедуру, фрагмент-доказательство, уровень уверенности и шаги ручной проверки в Конфигураторе или EDT. Продуктовые сборки публикуются через двухфазный процесс: подписанная сборка, проверка тех же файлов на чистой Windows, затем публикация без пересборки.
Для кого. Для 1С-команд, которым нужны быстрые обоснованные ответы на вопросы о конфигурации (где пишется регистр, кому принадлежит форма, что изменилось между выгрузками) с доказательствами вместо угадывания по обрывкам кода.
Подходит, если
- Нужен быстрый обоснованный ответ на вопрос о структуре большой конфигурации 1С
- Нужен поиск по справке платформы локально, без обращения к сети
- Нужно дать агенту read-only доступ к коду и метаданным без риска случайной записи в базу
Не подходит, если
- Нужна работа не на Windows: workbench рассчитан на Windows 10/11 с PowerShell
- Нужны живые операции с базой через ibcmd: они экспериментальны, выключены по умолчанию и требуют явного разрешения на запись
Пример запроса к агенту
Найди, где записывается регистр остатков товаров, и покажи путь к модулю с фрагментом кодаОграничения
Работает только на Windows 10/11 с PowerShell 5.1+, Git for Windows и Python 3.10+ для Python-мостов. Нужен подписанный установщик с готовым bsl-indexer.exe или Rust toolchain для сборки из исходников. Экспериментальный мост ibcmd для операций с базой выключен по умолчанию намеренно. У проекта есть коммерческая часть: премиум-промпты, эталонные ответы и поддержка доступны отдельно у мейнтейнера.
Как отключить. Остановите запущенные MCP-серверы workbench и удалите их записи из конфигурации MCP клиента (configs/*.json), сам workbench можно просто удалить с диска.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| IBCMD_ALLOW_WRITE | Явное включение экспериментальных операций записи через ibcmd, по умолчанию выключено. |
Проверка безопасности
- Дефолтный режим read-only, выгрузка зеркалируется и не изменяется индексацией
- Единственный путь записи, 1c-ibcmd, выключен по умолчанию и требует двойного явного подтверждения
Коротко о README
README дает статус готовности с метриками тестов (67/67 pytest, 8 PASS в e2e-smoke, healthcheck 6/6), объясняет архитектуру от XML-выгрузки через зеркало и Rust-индексатор до четырех Python-мостов, требования и быстрый старт через набор нумерованных скриптов. Раздел про каждый MCP-сервер дает команду запуска, раздел про контракт ответа перечисляет обязательные поля хорошего ответа ИИ, отдельно описана модель безопасности (read-only по умолчанию, ключи API у клиента, проприетарные бинарники не бандлятся). Указаны источники заимствований (cc-1c-skills, BSL Language Server, OneScript, Vanessa Runner) и коммерческое предложение мейнтейнера. Лицензия MIT, репозиторий REUSE-совместим.
Частые вопросы
Может ли workbench изменить базу или выгрузку?
По умолчанию нет: дефолтный режим локальный и read-only, выгрузка зеркалируется перед индексацией, а live write-путь через ibcmd выключен и требует явного разрешения.
Нужны ли проприетарные бинарники 1С в поставке?
Нет, README прямо указывает, что проприетарные бинарники 1С не бандлятся вместе с workbench.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything