Claude Debugs For You MCP

Установка

Работает в

• Claude Desktop
• Cursor
• VS Code
• SourceCraft
• Koda
• Coddy

Ручная установка

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

Что делает

Расширение запускает внутри VS Code HTTP-сервер MCP на порту 4711, а к нему подключается агент. Клиентам, которые умеют только stdio (Claude Desktop), расширение добавляет небольшой скрипт `mcp-debug.js`: он пересылает вызовы серверу расширения. Клиентам с поддержкой SSE (Cursor) достаточно адреса `http://localhost:4711/sse`. Агенту доступны три инструмента. `listFiles` перечисляет файлы рабочей области по маскам включения и исключения, `getFileContent` отдает файл с номерами строк по абсолютному пути. Третий, `debug`, принимает план из шагов: `setBreakpoint` (с необязательным условием), `removeBreakpoint`, `launch`, `continue` и `evaluate`. Запуск берет первую конфигурацию из `.vscode/launch.json` и подставляет в нее текущий файл вместо `${file}`. После каждого шага агент получает ответ отладчика: место остановки, значения вычисленных выражений и ошибки, а с версии 0.1.2 еще и исключения. Работает все, для чего в VS Code есть адаптер отладки и консоль отладчика, в том числе Python и C++.

Для кого. Для разработчиков в VS Code, у которых код ведет себя не так, как задумано, и которые хотят, чтобы агент сам прошел его в отладчике, а не гадал по тексту.

Пример запроса к агенту

Функция longest_substring_with_k_distinct возвращает не то, что нужно. Пройди ее в отладчике по шагам с точками останова и найди, где значения расходятся с ожидаемыми

MCP

Транспорт

stdio, sse

Авторизация

не нужна

Ограничения

Проект версии 0.1.2, последнее изменение в репозитории от 20 декабря 2025 года. Лицензия MIT. Нужен VS Code 1.96 или новее.

Агент работает с кодом и значениями в процессе, который запущен отладчиком. Выражения в `evaluate` выполняются в контексте отлаживаемой программы, поэтому запускайте отладку проектов, которым вы доверяете.

Расширение слушает порт 4711 (настройка `mcpDebug.port`) и создает сервер без явной привязки к `localhost`. Если порт доступен из сети, вызывать его инструменты сможет любой, кто получит к нему доступ по сети, а проверки доступа у сервера нет.

Сервер запускается вместе с VS Code (`mcpDebug.autostart` включено по умолчанию), а в нескольких окнах одновременно работает один: расширение предлагает передать его другому окну. Для запуска берется только первая конфигурация из `launch.json`.

Порядок шагов важен: точки останова ставят до запуска или во время паузы, а `continue` не используют, чтобы дойти до первой точки.

Как отключить. Выключите автозапуск в настройке `mcpDebug.autostart` или остановите сервер командой «Claude Debugs For You: Stop Server». Чтобы убрать полностью, удалите расширение из VS Code и блок `debug` из `claude_desktop_config.json` или адрес из настроек клиента.

Коротко о README

В репозитории показано, как поставить расширение и подключить клиент по stdio или SSE, и приведен пример запроса к агенту. Есть видеодемонстрации с Continue и Claude Desktop, настройка Continue с экспериментальным блоком серверов и подсказки по сборке расширения и пакета командой `vsce package`. Исходники лежат в каталогах `src` (расширение и сервер) и `mcp` (скрипт для stdio), примеры на Python в `examples`, история версий в `CHANGELOG.md`.