mcp-debugger

mcp-debugger — MCP-сервер сообщества (автор — debugmcp). Пошаговая отладка для агентов: точки останова и переменные на десяти языках. Ставится через Docker или через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
debugmcp
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Запускает и компилирует программы, вычисляет выражения в процессах, подключается к удалённым процессам.

Настройка клиентов

codex
{
    "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники