Node.js Debugger MCP
MCP-сервер отладчика Node.js: агент ставит точки останова, идет по шагам, смотрит переменные и вычисляет выражения в паузе
- 350 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сервер запускает скрипт Node.js на вашей машине с доступом отладчика к процессу
- Инструмент `evaluate_expression` выполняет произвольный JavaScript в приостановленном процессе
- В переменных и консоли могут оказаться секреты, и они попадут агенту и модели
Установка
- Работает в
Ручная установка
{
"devtools-debugger-mcp": {
"command": "devtools-debugger-mcp"
}
}Для глобальной установки: npm install -g devtools-debugger-mcp. Либо укажите command node и args с путем к dist/index.js после npm install devtools-debugger-mcp.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер запускает скрипт Node.js на вашей машине с доступом отладчика к процессу
- Инструмент `evaluate_expression` выполняет произвольный JavaScript в приостановленном процессе
- В переменных и консоли могут оказаться секреты, и они попадут агенту и модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту для программ на Node.js те же возможности отладки, что есть в Chrome DevTools и VS Code. Он запускает ваш скрипт с флагом `--inspect-brk=0`, ждет WebSocket инспектора и подключается по протоколу Chrome DevTools. В ответ агент получает первую паузу с идентификатором и верхним кадром стека. Дальше агент ставит точки останова по пути файла или по регулярному выражению адреса, а также условные точки и логпойнты. Он включает паузу на исключениях и ведет выполнение: шагает через вызов, внутрь или наружу, доходит до нужного места и перезапускает кадр. В паузе агент читает переменные с замыканиями и свойства объектов, стек вызовов и вывод консоли с прошлого шага, а выражения вычисляет в выбранном кадре. Сервер понимает исходные карты, поэтому отлаживать можно и TypeScript, и другой транспилируемый код. Ответы приходят в формате `text`, `json` или в обоих сразу. Всего инструментов больше двадцати, от `start_node_debug` до `stop_debug_session`.
Для кого. Для разработчиков Node.js, которые хотят, чтобы агент искал причину сбоя в запущенном процессе по реальным значениям переменных.
Подходит, если
- Скрипт падает на исключении, и агент должен остановиться в этом месте и показать значения переменных
- Нужно поставить условную точку останова, срабатывающую только для одного пользователя или запроса
- Хочется добавить логпойнт без правки кода и посмотреть значения по ходу выполнения
- Код на TypeScript с исходными картами, и отладка должна идти по исходным строкам
- Нужно проверить гипотезу о значении выражения в конкретном кадре стека
Не подходит, если
- Нужна отладка браузерной страницы или Python: сервер запускает только скрипты Node.js
- Нужно подключиться к уже запущенному процессу, например в проде: сервер отлаживает только скрипты, которые запускает сам
- Достаточно логов и стека ошибки, и останавливать выполнение не нужно
- Нужна отладка внутри редактора с вашим `launch.json`: для этого есть расширения VS Code
Пример запроса к агенту
Запусти /abs/path/app.js под отладчиком, поставь точку останова на строке 42, дойди до нее и покажи значения локальных переменных и user.nameMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер отлаживает только программы на Node.js, которые запускает сам через `start_node_debug`: процесс стартует с паузой на первой строке, и дальше его ведет агент. Отладка браузерных страниц и других языков в проект не входит.
Готовых инструкций под конкретные клиенты нет, подключение сводится к общему блоку конфигурации MCP. Последний коммит в репозитории сделан в октябре 2025 года, поэтому совместимость с вашей версией Node.js стоит проверить на небольшом скрипте.
Как отключить. Удалите блок devtools-debugger-mcp из настроек MCP-клиента и перезапустите клиент. Пакет снимается командой `npm uninstall devtools-debugger-mcp`. Активную сессию отладки закрывает инструмент `stop_debug_session`.
Частые вопросы
Как подключить отладчик Node.js к агенту?
Поставьте пакет `npm install devtools-debugger-mcp` и добавьте в настройки MCP блок с командой `node` и путем к `dist/index.js` или с глобальной командой `devtools-debugger-mcp`. После перезапуска клиента агент получит инструменты отладки.
Как начать сессию отладки?
Вызовом `start_node_debug` с абсолютным путем к скрипту. Сервер запускает Node с `--inspect-brk=0`, подключается к инспектору и останавливается на первой строке. Затем ставят точки останова и вызывают `resume_execution`.
Можно ли отлаживать TypeScript?
Да. Сервер поддерживает исходные карты, поэтому точки останова и шаги идут по исходным строкам транспилируемого кода.
Что такое логпойнт?
Условная точка останова, которая пишет сообщение в консоль и возвращает false, поэтому выполнение не останавливается. Ее создает инструмент `add_logpoint`, а сообщения читает `read_console`.
Как управлять объемом ответа?
Инструмент `set_output_format` задает формат ответов по умолчанию: `text`, `json` или оба. Тот же параметр `format` принимает каждый инструмент. У шагов и продолжения есть флаги, добавляющие в ответ области видимости, стек и консоль.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный сервер MCP от Microsoft для отладки: расширение VS Code и CLI дают агенту точки останова, шаги, переменные и вычисление выражений
Расширение VS Code с MCP-сервером: агент ставит точки останова, запускает отладку по вашему launch.json и вычисляет выражения на любом языке
Локальный инструмент для проверки и отладки MCP-серверов: чат с инструментами, просмотр вызовов и прогоны оценок по разным клиентам
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Node.js Debugger MCP (эта запись) | нет | не нужна | 350 | |
| DebugMCP | да | не нужна | 577 | официальный сервер Microsoft: расширение VS Code и CLI с точками останова для многих языков |
| Claude Debugs For You | нет | не нужна | 514 | расширение VS Code с MCP-сервером, которое отлаживает по вашему launch.json |
| Chrome DevTools MCP | да | не нужна | 54 432 | официальный сервер команды Chrome DevTools для живого браузера, сети и консоли |
Коротко о README
Описание объясняет, зачем серверу отладочный доступ, и перечисляет возможности. Дальше идут установка, блок конфигурации, пошаговый пример из шести вызовов и справочник по каждому инструменту с параметрами.