mcp-debugger
Отладчик без среды разработки: агент ставит точки останова, шагает по коду и смотрит переменные в десяти языках
- 188 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Отладка запускает вашу программу с правами агента, а вычисляемые выражения выполняют код внутри нее
- Подключение к процессам на других машинах и в подах открывает доступ к их состоянию и данным
Установка
- Работает в
Ручная установка
npx -y @debugmcp/mcp-debugger stdioЗапуск по stdio; клиенты стартуют его сами.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Отладка запускает вашу программу с правами агента, а вычисляемые выражения выполняют код внутри нее
- Подключение к процессам на других машинах и в подах открывает доступ к их состоянию и данным
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-debugger превращает пошаговую отладку в вызовы MCP. Агент запускает программу под настоящим отладчиком языка через протокол Debug Adapter, ставит точки останова, шагает, вычисляет выражения и смотрит стек и переменные. Поддержаны Python (debugpy), JavaScript и Node.js (js-debug), Ruby (rdbg), Rust и C/C++ (CodeLLDB), Go (Delve), Java (JDI), .NET (netcoredbg), COBOL и Dart с Flutter, включая горячую перезагрузку. Среда разработки не нужна: сервер работает везде, где есть Node.js, то есть в CI, контейнерах, подах Kubernetes, по SSH и в песочницах облачных агентов. Есть подключение к процессу на другой машине без IDE и точки с записью в журнал без остановки программы. Транспорт stdio или Streamable HTTP, каждая сессия отладки получает отдельный процесс. По умолчанию значения переменных, выражений и вывода маскируются от секретов. Репозиторий ставится как пакет npm, образ Docker и навык.
Для кого. Разработчикам, чей агент работает в терминале, CI или облачной песочнице и должен находить ошибки отладчиком, а не добавлением вывода в код.
Подходит, если
- Тест падает только в контейнере, и агент подключается отладчиком к процессу в поде Kubernetes
- Исключение происходит редко, и агент ставит точку останова с условием и смотрит локальные переменные
- Приложение на Flutter ведет себя странно, и агент меняет код с горячей перезагрузкой
- На продакшене нельзя останавливать процесс, поэтому ставят точки с записью значений в журнал
- Старый код на COBOL разбирают пошагово, смотря значения WORKING-STORAGE
Не подходит, если
- Агент работает внутри открытого VS Code: подойдет сервер, который управляет отладчиком редактора
- Нужен отладчик PHP: этого языка в списке нет
- Ошибку видно из лога и трассировки: запуск отладчика избыточен
Пример запроса к агенту
Запусти `app.py` под отладчиком, поставь точку останова в функции `parse_order` и покажи значения переменных при паденииMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Сервер запускает отладчик языка, который должен быть доступен на машине: для Java нужен JDK 21 или новее, для Rust в Windows набор GNU, а C/C++ идет через CodeLLDB. Отладка исполняет вашу программу с правами агента, а выражения в `evaluate` выполняют код в ней. Маскировка секретов включена по умолчанию, но проверьте, что она не отключена параметрами. PHP не поддерживается. Часть возможностей, например замена кода в Java и перезагрузка в Flutter, зависит от адаптера языка.
Как отключить. Удалите сервер в клиенте (`claude mcp remove mcp-debugger`) и остановите запущенные сессии отладки.
Частые вопросы
Как подключить mcp-debugger?
Добавьте в конфигурацию MCP клиента команду `npx -y @debugmcp/mcp-debugger stdio`. Для Codex: `codex mcp add mcp-debugger -- npx -y @debugmcp/mcp-debugger stdio`.
Какие языки поддерживаются?
Python, JavaScript и TypeScript, Ruby, Rust, Go, Java, .NET, C и C++, COBOL, Dart и Flutter.
Нужен ли VS Code?
Нет, сервер работает отдельным процессом Node.js. Для просмотра есть режим `expose_session`, который показывает сессию агента в среде разработки только для чтения.
Можно ли отлаживать процесс в Kubernetes?
Да. Подключение к подам идет через port-forward для debugpy, rdbg и JDWP, а для нативного кода есть сценарий с `kubectl debug` и эфемерным контейнером.
Утекают ли секреты в ответы агента?
По умолчанию значения переменных, выражений и вывода маскируются, а режим минимальных прав дополнительно ограничивает доступ. Проверяйте настройки перед запуском на боевых данных.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер отладчика: агент ставит точки останова, шагает по коду и читает переменные живой программы через DAP.
MCP-сервер отладчика Node.js: агент ставит точки останова, идет по шагам, смотрит переменные и вычисляет выражения в паузе
Официальный сервер MCP от Microsoft для отладки: расширение VS Code и CLI дают агенту точки останова, шаги, переменные и вычисление выражений
Плагин для IDE JetBrains отдает отладчик агенту: точки останова, шаги, переменные и вычисление выражений по MCP.
Расширение VS Code с MCP-сервером: агент ставит точки останова, запускает отладку по вашему launch.json и вычисляет выражения на любом языке
Отладчик dbg для ИИ-агентов: точки останова, шаги и переменные через короткие @ref вместо print-отладки и длинных логов
Коротко о README
README сравнивает сервер с отладчиком на базе VS Code по таблице возможностей, перечисляет поддерживаемые языки и ведет к установке через npx, Docker и навык. Отдельные разделы посвящены Kubernetes, Dart и Flutter, точкам с записью и маскировке секретов.