DebugMCP (MCP server) — Сценарии использования, Установка & Живое демо

Name: DebugMCP MCP Server
Author: microsoft

Зачем использовать

Ключевые функции

14 инструментов отладчика — старт/стоп, step over/into/out, точки останова, evaluate
Точки останова по содержимому строки (устойчивы к правкам кода)
9 языков через существующие языковые расширения VS Code
100% локально — нет телеметрии, не нужны учётные данные
MCP-сервер автоматически регистрируется при активации расширения

Живое демо

Как выглядит на практике

debug-mcp-microsoft.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "debug-mcp-microsoft",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "debug-mcp-microsoft": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://localhost:3001/mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add debug-mcp-microsoft -- npx -y mcp-remote http://localhost:3001/mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: DebugMCP

Попросить Claude пошагово пройти упавший тест вместо чтения print-вывода

👤 Бэкенд- и app-разработчики ⏱ ~15 min beginner

Когда использовать: Тест падает без внятного стектрейса — отладка через print займёт вечность.

Предварительные требования

DebugMCP установлен в VS Code — Marketplace → ozzafar.debugmcpextension
Языковое расширение отладки (например, Python для .py) — VS Code предложит установить при первом запуске

Поток

Настройка

Use debugmcp. Add a breakpoint on the line assert result == expected in tests/test_orders.py.✓ Скопировано

→ Точка останова установлена; строка совпала
Запуск

Start debugging tests/test_orders.py with the failing test.✓ Скопировано

→ Сессия приостановлена на точке останова
Инспекция

Show me all local variables. What's result actually contain?✓ Скопировано

→ Дамп переменных с конкретными значениями
Пошаговый разбор и диагноз

Step into the function that built result. Tell me where it diverged from expected.✓ Скопировано

→ Корневая причина с привязкой к коду

Итог: Баг найден пошаговой отладкой, а не догадками — минуты вместо часа.

Подводные камни

Точка останова по номеру строки сдвигается после правок — Используйте совпадение по содержимому строки (DebugMCP поддерживает это нативно)

Сочетать с: filesystem

Поймать heisenbug с помощью условных точек останова

👤 Разработчики, столкнувшиеся с нестабильными багами ⏱ ~25 min intermediate

Когда использовать: Баг воспроизводится только при определённом вводе — нужно остановиться именно на нём.

Поток

Условная точка останова

Add a breakpoint at the process(order) call that fires only when order.id starts with 'EXP-'.✓ Скопировано

→ Условная точка останова установлена
Воспроизведение

Run the integration suite. When we stop, evaluate the order DTO and the request headers.✓ Скопировано

→ Точный входной провоцирующий запрос захвачен

Итог: Heisenbug превращается в обычный баг.

Подводные камни

Условный eval замедляет цикл — Сузьте условие; держите его чистым (без побочных эффектов)

Использовать отладчик как документацию для незнакомого кода

👤 Новые сотрудники, изучающие сервис ⏱ ~30 min beginner

Когда использовать: Вы получили сервис в наследство, и поток данных непрозрачен.

Поток

Трассировка входной точки

Set a breakpoint at the HTTP handler for /orders. Run a sample request and step through every call until response is returned. Narrate as you go.✓ Скопировано

→ Пошаговая трассировка с аннотациями file:line

Итог: Поведенческая карта сервиса, которую не описала ни одна диаграмма.

Подводные камни

Трассировка уходит слишком глубоко — Используйте step_over для скучных кадров, step_into — только для интересных

Комбинации

Сочетайте с другими MCP — эффект x10

debug-mcp-microsoft + filesystem

Читать исходный код в процессе пошаговой отладки для принятия решений

Step into the call. While paused, show me the surrounding function via filesystem.✓ Скопировано

debug-mcp-microsoft + github

Открыть PR с исправлением, которое вы только что верифицировали через отладчик

We confirmed the bug. Open a PR with the fix and reference the debug session in the description.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
start_debugging	fileFullPath, workingDirectory, testName?, configurationName?	Начало сессии отладки	free
add_breakpoint	fileFullPath, lineContent	Поставить точку останова по содержимому кода	free
step_over	(none)	Перейти на одну строку вперёд	free
step_into	(none)	Войти в вызываемую функцию	free
get_variables_values	scope: 'local'\|'global'\|'all'	Инспекция состояния в текущей точке паузы	free
evaluate_expression	expression: str	Проверить гипотезу без перезапуска	free
list_breakpoints	(none)	Проверить текущий набор точек останова	free

Стоимость и лимиты

Во что обходится

Квота API: Локально — нет квоты
Токенов на вызов: 100–500 на каждое отладочное действие
Деньги: Бесплатно (MIT)
Совет: Пошаговая отладка дешевле, чем цикл print-debug; обменяйте токены на более быструю диагностику

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Local file read for source mapping

Хранение учётных данных: Нет — учётные данные не нужны

Исходящий трафик: Нет — полностью локально

Никогда не давайте: Network exposure of port 3001

Не привязывайте к 0.0.0.0; держите только на localhost

Устранение неполадок

Частые ошибки и исправления

MCP server not detected after install

Перезапустите VS Code; убедитесь, что расширение включено и порт 3001 свободен

Проверить: curl http://localhost:3001/mcp

Language not supported

Сначала установите соответствующее языковое расширение для отладки VS Code (например, ms-python.python для Python)

Проверить: Запустите отладку вручную из интерфейса VS Code для проверки

Breakpoint never hits

Несоответствие source map — убедитесь, что отлаживаете тот же артефакт, который редактировали

Проверить: Проверьте путь `program` в launch.json

Альтернативы

DebugMCP в сравнении

Альтернатива	Когда использовать	Компромисс
Print / log statements	Быстрая разовая проверка без подключения IDE	Дёшево, но долгая итерация; засоряет кодовую базу
Language-specific REPL	Нужна только посмертная инспекция	Нет пошагового выполнения; беднее полноценного отладчика

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills