mcp-debugger
mcp-debugger — MCP-сервер сообщества (автор — debugmcp). Пошаговая отладка для агентов: точки останова и переменные на десяти языках. Ставится через Docker или через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- debugmcp
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Запускает и компилирует программы, вычисляет выражения в процессах, подключается к удалённым процессам.
Настройка клиентов
{
"code": "codex mcp add mcp-debugger -- npx -y @debugmcp/mcp-debugger stdio\ncodex mcp list",
"lang": "bash",
"notes": "Запись сохраняется в ~/.codex/config.toml",
"verified": "docs"
}
Что умеет
mcp-debugger — MCP-сервер, который превращает пошаговую отладку в структурированные вызовы инструментов. ИИ-агент ставит точки останова, смотрит переменные, вычисляет выражения и идёт по шагам в работающей программе. IDE не нужна: сервер работает везде, где есть Node.js, — в CI, Docker-контейнерах, подах Kubernetes, на серверах по SSH и в песочницах облачных агентов.
Поддерживаются десять языков: Python (debugpy), JavaScript и TypeScript (js-debug), Ruby (rdbg), Rust и C/C++ (CodeLLDB), Go (Delve), Java (JDK 21+), .NET/C# (netcoredbg), COBOL (GnuCOBOL + CodeLLDB) и Dart/Flutter (отладчики из SDK). Основные возможности по README:
- Удалённое подключение к процессу на другой машине или в контейнере по адресу и порту; для Kubernetes — проброс порта или
kubectl debugс подключением по PID. - Точки останова, переживающие правки: адресация по содержимому строки, по имени функции или с проверкой
expectedContent. - Logpoints: значения выводятся в
get_outputбез остановки программы. - Полный цикл точек останова: список, удаление, очистка на лету и
restart_debuggingс повторным применением настроек. - Вывод программы через
get_output, а также как подписываемый MCP-ресурс. - Отладка падений: при необработанном исключении сессия останавливается со стеком и локальными переменными.
- Зеркало для IDE:
expose_sessionоткрывает локальную точку доступа с токеном, чтобы человек смотрел сессию агента только на чтение. - Маскирование секретов по умолчанию: ключи, токены и приватные ключи скрываются в переменных, вычислениях и выводе.
- Hot reload для Flutter и hot-swap для Java.
Транспорты — stdio и Streamable HTTP. В репозитории есть навык для агентов с методикой отладки.
Кому подойдёт
- Командам с облачными и терминальными агентами, которым нужна отладка без IDE.
- DevOps-инженерам, разбирающим проблемные поды в Kubernetes.
- Разработчикам CI: в репозитории есть GitHub Action, который запускает отладчик и агента на упавшем тесте.
Похожие серверы — в категории разработка.
Установка
Серверу нужен Node.js 22+, а для каждого отлаживаемого языка — свой инструментарий (Python с debugpy, Go с Delve, JDK 21+ и так далее). Запуск без установки: npx @debugmcp/mcp-debugger. Есть Docker-образ debugmcp/mcp-debugger, который монтирует текущую папку в /workspace. Для Claude Code в репозитории есть скрипт ./scripts/install-claude-mcp.sh. Аргумент stdio обязателен, иначе вывод в консоль ломает протокол. Для запуска на порту используйте mcp-debugger http --port 3001 и указывайте в клиенте адрес http://127.0.0.1:3001/mcp.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"mcp-debugger": {
"command": "node",
"args": ["C:/path/to/mcp-debugger/dist/index.js", "stdio", "--log-level", "debug", "--log-file", "C:/path/to/logs/debug-mcp-server.log"],
"disabled": false,
"autoApprove": ["create_debug_session", "set_breakpoint", "get_variables"]
}
}
}В JSON замените пути на путь к собранному dist/index.js и к файлу журнала. Codex сохраняет запись в ~/.codex/config.toml; её используют Codex CLI, расширение для IDE и десктопное приложение на той же машине.
Проверка
В Codex выполните /mcp и убедитесь, что mcp-debugger подключён. Затем попросите агента запустить отладку небольшого скрипта и остановиться на первой строке функции main.
Примеры задач
Тест test_checkout падает. Запусти его под отладчиком, остановись на исключении и найди причину.Подключись к Python-сервису в поде через проброс порта и посмотри значение переменной total без остановки.Риски
- Запуск кода. Отладчик запускает программы, компилирует исходники C/C++ и COBOL и вычисляет произвольные выражения в процессе — это равносильно выполнению команд.
- Доступ к файлам и памяти процессов: исходники, переменные, вывод программ.
- Сеть. Удалённое подключение к процессам и HTTP-режим; не открывайте порт наружу без защиты.
- Автоподтверждение. Пример конфига разрешает
autoApproveдля части инструментов — уберите его, если хотите подтверждать каждый шаг. - Маскирование секретов включено по умолчанию, но не гарантирует, что ничего не утечёт.
Частые вопросы
Чем отличается от DebugMCP от Microsoft?
DebugMCP требует запущенный VS Code, а mcp-debugger работает как отдельный процесс без IDE.
Нужно ли ставить отладчики языков отдельно?
Да, кроме Docker-образа: в нём уже есть инструменты для Python, JavaScript, Java, Rust, C/C++, COBOL и Dart.
Можно ли отлаживать в Kubernetes?
Да, через проброс порта для интерпретируемых языков или kubectl debug с подключением по PID для нативных.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.