1C Debug MCP Server
MCP-сервер отладки 1С через HTTP Debug Protocol: точки останова, пошаговое выполнение, переменные и стек вызовов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Дает доступ к переменным и выполнению кода в сессии отладки боевой или тестовой базы
- Точки останова могут приостановить работу пользователей на подключенной базе
Установка
Ручная установка
cd 1c-debug-mcp/go
go build -o dist/1c-debug-mcp.exe ./cmd/1c-debug-mcp/Сборка версии 2.0 на Go, требует Go 1.23+ и Windows для запуска dbgs.exe.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к серверу отладки 1С:Предприятие dbgs.exe и дает агенту управлять отладкой: ставить точки останова в модулях конфигурации, расширений и внешних обработок, выполнять код пошагово, ставить на паузу, читать локальные переменные, вычислять BSL-выражения в контексте остановки и смотреть стек вызовов. objectID модулей резолвится автоматически по имени из метаданных, а сами метаданные кешируются для быстрого старта на больших конфигурациях. Версия 2.0 переписана на Go в единый бинарник без внешних зависимостей, предыдущая версия на TypeScript тоже осталась в репозитории.
Для кого. Для 1С-разработчиков, которые хотят, чтобы агент сам ставил точки останова и разбирался в падениях кода вместо ручной работы в отладчике.
Подходит, если
- Нужно, чтобы агент воспроизвел ошибку в 1С через пошаговую отладку, а не только чтение кода
- Работаете в Kiro или другом клиенте с поддержкой stdio MCP на Windows
- Нужно быстро подключаться к большим конфигурациям благодаря кешу метаданных
Не подходит, если
- Сервер отладки dbgs.exe недоступен или отладка на этой базе запрещена регламентом
- Нужна кроссплатформенность без Windows-специфичных путей в конфигурации
- Нельзя разрешать агенту читать значения переменных боевой сессии
Пример запроса к агенту
Поставь точку останова в модуле обработки проведения документа Заказ и покажи значения переменных при остановкеОграничения
Нужен запущенный сервер отладки 1С (dbgs.exe) и 1С:Предприятие 8.3. Сборка из исходников требует Go 1.23+, конфигурация в примерах ориентирована на Windows-пути. Глобальный и локальный env в конфигурации Kiro не мержатся: параметры нужно дублировать в локальном файле.
Как отключить. Отключите сервер 1c-debug в панели MCP Servers клиента или удалите его блок из .kiro/settings/mcp.json.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| ONEC_DEBUG_URL обязательная | URL сервера отладки 1С dbgs.exe |
| ONEC_INFOBASE_ALIAS обязательная | Алиас базы для подключения отладчика |
| ONEC_DEBUG_PASSWORD секрет | Пароль сервера отладки, если задан |
| ONEC_CF_PATH | Путь к выгруженной конфигурации для сопоставления модулей |
Проверка безопасности
- Дает доступ к переменным и выполнению кода в сессии отладки боевой или тестовой базы
- Точки останова могут приостановить работу пользователей на подключенной базе
Коротко о README
README на русском описывает возможности версии 2.0 на Go: подключение к dbgs.exe, точки останова, авторезолвинг objectID, кеш метаданных, пошаговое выполнение и вычисление выражений. Дана таблица параметров конфигурации ONEC_* для .kiro/settings/mcp.json и список инструментов attach, detach, force_detach, get_targets, set_breakpoints и других с примерами параметров и ответов. Отдельно перечислены документы ARCHITECTURE, CACHE, PERFORMANCE и FAQ.
Частые вопросы
Нужен ли Node.js для версии 2.0?
Нет, версия 2.0 переписана на Go и собирается в единый бинарник без зависимостей.
Что делать при ошибке ibInDebug или зависшей сессии?
Вызвать инструмент force_detach, который принудительно останавливает ping-цикл и очищает сессию.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything