Skip to main content
Glama
chrome-debugger-mcp

chrome-debugger-mcp

by BitePro

chrome-debugger-mcp

English | 中文

English

MCP-сервер для отладки Chrome на основе точек останова.

chrome-debugger-mcp предоставляет примитивы Chrome DevTools Protocol в виде MCP-инструментов, чтобы AI-агент мог подключиться к реальной вкладке Chrome, приостановить выполнение, просмотреть значения в областях видимости, выполнить выражения внутри текущего кадра вызова и пройтись по коду по шагам, опираясь на фактические данные времени выполнения, а не на догадки по статическому исходному коду.

Это не универсальный сервер автоматизации браузера. Основной фокус — отладка во время выполнения.

Основные возможности

  • Подключение к реальной вкладке Chrome через CDP после явного подтверждения пользователем

  • Приостановка на точках останова или операторах debugger; и ожидание именно той паузы, которую вы ожидаете

  • Чтение значений локальной, замыкающей и модульной областей видимости из приостановленного кадра

  • Выполнение JavaScript в текущем кадре вызова и продвижение выполнения по шагам

  • Чистое возобновление работы, чтобы агент мог продолжать с фактическими значениями времени выполнения

Демонстрация

chrome-debugger-mcp demo

Демонстрация: агент запускает Chrome, ожидает точку останова, проверяет реальные переменные области видимости и возобновляет работу с фактами времени выполнения, а не с догадками.

Конфигурация MCP-клиента

Использование опубликованного пакета

{
  "mcpServers": {
    "chrome-debugger": {
      "command": "npx",
      "args": ["-y", "chrome-debugger-mcp"]
    }
  }
}

Установка

Из npm

npx -y chrome-debugger-mcp

Или установите глобально:

npm install -g chrome-debugger-mcp

Из исходного кода

pnpm install
pnpm build
node dist/index.js

Другие особенности

  • Запуск выделенного экземпляра Chrome с включенной удалённой отладкой

  • Установка и удаление точек останова DevTools без редактирования исходного кода

  • Перезагрузка страницы через CDP, чтобы точки останова надёжно привязывались после навигации

  • Опрос состояния отладчика, когда у MCP-клиента короткие тайм-ауты запросов

  • Выдача _ui-полезных данных и сообщений журнала, которые клиенты могут показывать пользователю

Почему это полезно

Многие MCP-инструменты, ориентированные на браузер, сильны в работе с DOM и проверке сети, но слабы в отладке времени выполнения. Этот сервер даёт MCP-клиенту недостающий цикл, который вы обычно используете в Chrome DevTools: подключиться к нужной вкладке, приостановиться в нужный момент, проверить реальные значения, при необходимости пройтись по шагам и чисто возобновить работу.

Он также добавляет ограничения, предотвращающие типичные ошибки агента:

  • угадывание, к какой вкладке подключаться;

  • вывод о поведении без проверки значений времени выполнения;

  • завершение хода между reloadPage() и waitForSpecificPause().

Требования

  • Локально установленный Google Chrome

  • MCP-клиент, поддерживающий серверы stdio и вызов инструментов

  • Доступ к приложению, которое вы хотите отлаживать

  • Локальный доступ к исходному коду, если вы планируете вставлять временные операторы debugger;

Модель инструментов

Сервер работает через stdio и предоставляет MCP-инструменты. Наиболее важные инструменты:

  • startDebuggingSession: возвращает рекомендуемый порядок отладки и критические правила поведения агента

  • launchChrome: запускает выделенный экземпляр Chrome с включенной удалённой отладкой

  • listTargets: перечисляет доступные вкладки Chrome и требует, чтобы пользователь выбрал одну

  • connect: подключается к подтверждённой вкладке

  • setBreakpoint: создаёт точку останова CDP без изменения исходных файлов

  • removeBreakpoint: удаляет точку останова, созданную setBreakpoint

  • reloadPage: перезагружает текущую страницу через CDP

  • waitForSpecificPause: ожидает следующую паузу и проверяет, совпадает ли она с целевым файлом и строкой

  • waitForPause: ожидает любую паузу без сопоставления с местоположением

  • getScopeVariables: считывает значения локальной, замыкающей и модульной областей видимости из приостановленного кадра

  • evaluate: выполняет JavaScript в приостановленном кадре вызова

  • stepInto, stepOver, stepOut: стандартное управление выполнением

  • resume: возобновляет выполнение после проверки

  • getStatus: неблокирующий опрос состояния подключения или паузы

  • forcePause: запрашивает паузу на следующем операторе JavaScript

Рекомендуемый порядок действий

Для AI-клиентов предусмотрен следующий порядок:

  1. Вызовите startDebuggingSession().

  2. Вызовите launchChrome() или используйте уже запущенный экземпляр Chrome с портом CDP.

  3. Вызовите listTargets() и покажите пользователю полный список вкладок.

  4. Дождитесь, пока пользователь подтвердит точный URL страницы.

  5. Вызовите connect({ targetUrl }).

  6. Вставьте временный оператор debugger; в локальный исходный код или вызовите setBreakpoint().

  7. Вызовите reloadPage().

  8. Сразу же вызовите waitForSpecificPause() в том же ходе.

  9. Вызовите getScopeVariables() и evaluate(), чтобы проверить значения времени выполнения.

  10. При необходимости пройдите по шагам с помощью stepInto(), stepOver() или stepOut().

  11. Вызовите resume().

  12. Удалите временные операторы debugger; из исходного кода.

Важные правила для авторов агентов

Этот сервер предназначен для агентов, использующих инструменты, а не только для людей. Если вы интегрируете его в MCP-клиент, соблюдайте эти правила:

  • Никогда не пропускайте listTargets().

  • Никогда не угадывайте целевой URL, даже если открыта только одна вкладка.

  • Всегда ждите явного подтверждения пользователя перед connect().

  • После reloadPage() немедленно вызывайте waitForSpecificPause() или waitForPause() в том же ходе.

  • Не объясняйте поведение по статическому коду, когда значения времени выполнения можно проверить напрямую.

  • Всегда вызывайте resume() после проверки.

  • Если вы добавили временные операторы debugger; в исходный код, удалите их перед завершением.

Как waitForSpecificPause выполняет сопоставление

waitForSpecificPause — предпочтительный примитив ожидания, поскольку он надёжнее, чем ожидание произвольной паузы.

Он сопоставляет паузу с помощью двух стратегий:

  1. Фрагмент URL плюс допуск по номеру строки

  2. Фрагмент URL плюс причина паузы debugger-statement

Второй путь важен, когда карты исходного кода, транспиляция или сборка смещают скомпилированные номера строк относительно номеров строк редактора.

Пример последовательности инструментов

Агент, отлаживающий локальное приложение Vite, может сделать примерно следующее:

  1. launchChrome({ dryRun: true })

  2. launchChrome()

  3. listTargets()

  4. Ожидание подтверждения пользователем http://127.0.0.1:5173

  5. connect({ targetUrl: "127.0.0.1:5173" })

  6. Вставка debugger; в App.jsx

  7. reloadPage()

  8. waitForSpecificPause({ urlFragment: "App.jsx", line: 62, actionHint: "click the Refetch payloads button" })

  9. getScopeVariables()

  10. evaluate({ expression: "payload.modules" })

  11. resume()

Поведение при запуске Chrome

launchChrome() использует выделенный профиль, поэтому не мешает обычной сессии браузера пользователя.

Значения по умолчанию:

  • порт удалённой отладки: 9222

  • каталог профиля: ~/.chrome-debug-profile

Ожидаемые пути к исполняемому файлу Chrome:

  • macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

  • Linux: google-chrome

  • Windows: C:\Program Files\Google\Chrome\Application\chrome.exe

Если автоматический запуск не удался, инструмент возвращает команду, которую пользователь может выполнить вручную.

Локальная площадка

В этом репозитории есть одноразовое тестовое приложение в test/, чтобы вы могли проверить сервер отладчика в реалистичном сценарии работы с браузером.

Запуск имитационного сервиса

cd test/service
node src/server.js

Сервис слушает http://127.0.0.1:3030.

Запуск веб-приложения

cd test/web
pnpm install
pnpm dev

Веб-приложение работает на http://127.0.0.1:5173.

Полезные места для паузы:

  • test/web/src/App.jsx внутри loadWorkbench

  • test/web/src/App.jsx внутри loadModuleDetail

  • test/web/src/App.jsx вокруг незавершённых разделов с деталями

Области полезных данных времени выполнения, которые стоит проверить:

  • summaryCards

  • modules

  • apiContracts

  • nextActions

  • responseShape

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

Не найдены цели

Убедитесь, что Chrome запущен с --remote-debugging-port=9222 и целевая страница открыта.

targetUrl совпадает с несколькими вкладками

Передайте более специфичную подстроку, чтобы совпадение стало уникальным.

waitForPause или waitForSpecificPause истёк по времени

Это может произойти, когда:

  • действие на странице так и не было выполнено;

  • была установлена не та точка останова;

  • у самого MCP-клиента тайм-аут запроса короче, чем вызов инструмента.

Если ваш клиент быстро завершается по тайм-ауту, используйте getStatus() для опроса или увеличьте тайм-аут клиента.

Номер строки паузы не совпадает с номером строки в редакторе

Сборщики и транспиляторы могут смещать скомпилированные номера строк. Используйте waitForSpecificPause() и полагайтесь на сопоставление по фрагменту URL плюс семантику debugger-statement.

Chrome не запускается автоматически

На машине может использоваться нестандартный путь установки Chrome. Выполните возвращённую команду запуска вручную или адаптируйте реализацию под ваше окружение.

Разработка

pnpm install
pnpm build
node dist/index.js

Реализация находится в:

  • src/index.ts: определения MCP-инструментов и подсказки рабочего процесса для пользователя

  • src/chrome-manager.ts: интеграция с Chrome DevTools Protocol и управление состоянием отладчика

Лицензия

MIT

Related MCP server: MCP JS Debugger

中文

一个面向 Chrome 断点调试的 MCP Server。

chrome-debugger-mcp 把 Chrome DevTools Protocol 的核心调试能力暴露为 MCP 工具,让 AI agent 可以连接真实的 Chrome 标签页,在运行时暂停执行、读取作用域变量、在当前调用帧中执行表达式、单步跟踪代码,并基于真实值继续任务,而不是只靠静态源码猜测行为。

它不是通用浏览器自动化工具。它的重点是运行时调试。

核心能力

  • 在用户明确确认后,通过 CDP 连接真实的 Chrome 标签页

  • 在断点或 debugger; 命中时暂停,并等待指定文件和行附近的 pause

  • 读取当前暂停帧中的 local、closure、module 作用域变量

  • 在当前调用帧里执行 JavaScript,并继续单步跟踪

  • 检查完成后恢复执行,让 agent 基于真实运行时值继续工作

功能演示

chrome-debugger-mcp 演示图

演示流程:agent 拉起 Chrome,等待断点命中,读取真实作用域变量,再基于运行时事实继续执行,而不是靠猜测推进。

MCP 客户端配置

使用已发布包

{
  "mcpServers": {
    "chrome-debugger": {
      "command": "npx",
      "args": ["-y", "chrome-debugger-mcp"]
    }
  }
}

安装方式

从 npm 使用

npx -y chrome-debugger-mcp

也可以全局安装:

npm install -g chrome-debugger-mcp

从源码运行

pnpm install
pnpm build
node dist/index.js

其他特点

  • 启动带远程调试端口的独立 Chrome 实例

  • 无需修改源码即可设置和移除断点

  • 通过 CDP 重载页面,确保跳转后断点可靠绑定

  • 当 MCP 客户端请求超时较短时,可轮询调试器状态

  • 输出 _ui 结果和 logging 消息,方便客户端展示给用户

为什么适合这个场景

很多浏览器方向的 MCP 工具更擅长 DOM 操作和网络请求观察,但不擅长回答运行时调试问题。这个服务补上的是 Chrome DevTools 里最关键的那条链路:连接正确标签页、在正确时机暂停、读取真实值、必要时单步跟踪、最后恢复执行。

它也内置了几条 guardrails,避免 agent 出现这些常见错误:

  • 猜测应该连接哪个标签页

  • 没看运行时值就直接下结论

  • 在 reloadPage() 和 waitForSpecificPause() 之间错误地结束当前轮次

运行要求

  • 本机安装了 Google Chrome

  • 使用支持 stdio MCP server 和工具调用的 MCP 客户端

  • 可以访问你要调试的应用

  • 如果要插入临时 debugger;,需要能访问本地源码

工具模型

这个服务通过 stdio 运行,并暴露一组 MCP tools。最核心的工具有:

  • startDebuggingSession:返回推荐调试流程和 agent 行为约束

  • launchChrome:启动带远程调试能力的独立 Chrome 实例

  • listTargets:列出可调试标签页,并要求用户做选择

  • connect:连接到已确认的目标标签页

  • setBreakpoint:在不改源码的情况下通过 CDP 设置断点

  • removeBreakpoint:移除通过 setBreakpoint 创建的断点

  • reloadPage:通过 CDP 重载当前页面

  • waitForSpecificPause:等待下一次暂停,并判断是否命中目标文件和行

  • waitForPause:不做位置匹配,等待任意暂停

  • getScopeVariables:读取当前暂停帧中的局部、闭包、模块作用域变量

  • evaluate:在暂停调用帧中执行 JavaScript

  • stepInto、stepOver、stepOut:标准单步控制

  • resume:检查完毕后恢复执行

  • getStatus:非阻塞方式查询是否已连接、是否已暂停

  • forcePause:请求在下一条 JavaScript 语句处暂停

推荐工作流

对于 AI 客户端,建议流程是:

  1. 调用 startDebuggingSession()。

  2. 调用 launchChrome(),或直接复用已经开启 CDP 端口的 Chrome。

  3. 调用 listTargets(),并把完整标签页列表展示给用户。

  4. 等待用户明确确认要调试的页面 URL。

  5. 调用 connect({ targetUrl })。

  6. 在本地源码插入临时 debugger;,或者调用 setBreakpoint()。

  7. 调用 reloadPage()。

  8. 在同一轮里立刻调用 waitForSpecificPause()。

  9. 调用 getScopeVariables() 和 evaluate() 检查运行时值。

  10. 必要时使用 stepInto()、stepOver()、stepOut() 继续跟踪。

  11. 调用 resume()。

  12. 删除源码里临时加入的 debugger;。

给 Agent 作者的重要规则

这个服务首先是为会调用工具的 agent 设计的,而不仅仅是给人手动点工具用。如果你要把它接入自己的 MCP 客户端,建议遵守这些规则:

  • 不要跳过 listTargets()。

  • 即使只看到一个标签页,也不要猜测目标 URL。

  • 一定要等用户明确确认后再调用 connect()。

  • 调用 reloadPage() 后,必须在同一轮里立刻调用 waitForSpecificPause() 或 waitForPause()。

  • 能读取运行时值时,不要只根据静态代码解释行为。

  • 检查完之后一定要 resume()。

  • 如果向源码里插入了临时 debugger;,结束前要清理掉。

waitForSpecificPause 如何匹配

waitForSpecificPause 是首选的等待工具,因为它比“等待任意暂停”更可靠。

它有两层匹配策略:

  1. URL 片段加行号容差

  2. URL 片段加 debugger-statement 暂停原因

第二层匹配对经过 source map、转译、打包后的代码尤其重要,因为编译后的行号可能和编辑器行号不完全一致。

调用序列示例

一个 agent 调试本地 Vite 应用时,调用顺序大致会像这样:

  1. launchChrome({ dryRun: true })

  2. launchChrome()

  3. listTargets()

  4. 等用户确认 http://127.0.0.1:5173

  5. connect({ targetUrl: "127.0.0.1:5173" })

  6. 在 App.jsx 插入 debugger;

  7. reloadPage()

  8. waitForSpecificPause({ urlFragment: "App.jsx", line: 62, actionHint: "click the Refetch payloads button" })

  9. getScopeVariables()

  10. evaluate({ expression: "payload.modules" })

  11. resume()

Chrome 启动行为

launchChrome() 会使用独立 profile,不会影响用户平时正在用的浏览器会话。

默认值:

  • 远程调试端口:9222

  • profile 目录:~/.chrome-debug-profile

默认 Chrome 可执行文件路径:

  • macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

  • Linux: google-chrome

  • Windows: C:\Program Files\Google\Chrome\Application\chrome.exe

Если автозапуск не сработал, инструмент вернёт команду запуска, которую пользователь сможет выполнить вручную.

Локальный Playground

В репозитории есть одноразовое тестовое приложение в каталоге test/. С его помощью можно проверить весь цикл работы этого отладочного MCP.

Запуск mock-сервиса

cd test/service
node src/server.js

Сервис принимает запросы на http://127.0.0.1:3030.

Запуск веб-приложения

cd test/web
pnpm install
pnpm dev

Веб-приложение работает на http://127.0.0.1:5173.

Рекомендуемые места для точек останова:

  • loadWorkbench в test/web/src/App.jsx

  • loadModuleDetail в test/web/src/App.jsx

  • рядом с ещё не завершённой областью detail в test/web/src/App.jsx

Поля payload, которые стоит посмотреть во время выполнения:

  • summaryCards

  • modules

  • apiContracts

  • nextActions

  • responseShape

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

Не удаётся найти targets

Убедитесь, что Chrome запущен с флагом --remote-debugging-port=9222 и целевая страница уже открыта.

targetUrl соответствует нескольким вкладкам

Передайте более специфичную подстроку URL, чтобы гарантировать уникальное совпадение.

Тайм-аут waitForPause или waitForSpecificPause

Распространённые причины:

  • операции на странице не были реально вызваны

  • точка останова установлена не в том месте

  • тайм-аут запроса самого MCP-клиента короче, чем время выполнения вызова инструмента

Если тайм-аут клиента короткий, можно перейти на опрос через getStatus(), либо увеличить тайм-аут клиента.

Номера строк при остановке не совпадают с редактором

Сборка и транспиляция приводят к смещению номеров строк в скомпилированном коде. Предпочтительнее использовать waitForSpecificPause() и полагаться на сопоставление фрагментов URL в сочетании с семантическим сопоставлением debugger-statement.

Не удаётся автоматически запустить Chrome

Путь установки Chrome на этой машине может не совпадать со значением по умолчанию. Можно напрямую выполнить команду запуска, возвращённую инструментом, или адаптировать реализацию под ваше окружение.

Разработка

pnpm install
pnpm build
node dist/index.js

Основные файлы реализации:

  • src/index.ts: определения MCP-инструментов и пользовательские подсказки по рабочим процессам

  • src/chrome-manager.ts: интеграция с Chrome DevTools Protocol и управление состоянием отладки

Лицензия

MIT

Available Tools

18 tools
connectA

[STEP 3] Connect the debugger to a specific Chrome tab. MANDATORY: call listTargets first, show the list to the user, wait for their explicit URL confirmation, then call this. NEVER guess the URL. NEVER skip user confirmation — even if only one tab is visible. targetUrl must be a unique substring of the tab URL the user confirmed (e.g. "localhost:5173"). Relay the "_ui" field from the response to the user.

Inputs: targetUrl (required), port.

disconnectA

Disconnect the current Chrome debugging session and clear in-memory pause state. Use this to explicitly end a debug session before connecting again.

Inputs: no named parameters.

evaluateA

[STEP 6b] Evaluate any JavaScript expression in the context of the currently paused call frame. Use this to inspect nested objects, call methods, compute derived values, or verify conditions at runtime. Complements getScopeVariables for values not directly visible in scope (e.g. this.state, JSON.stringify(obj)).

Inputs: expression (required), frameIndex.

forcePauseA

Force the debugger to pause at the very next JavaScript statement. Useful when you cannot modify source code to add debugger; and setBreakpoint is not feasible.

Inputs: no named parameters.

getScopeVariablesA

[STEP 6a] Read all scope variables (local, closure, module) at the currently paused call frame. Call this immediately after waitForSpecificPause or waitForPause returns. Results are grouped by scope type; global scope is skipped. Use frameIndex=1, 2, ... to inspect variables in parent call frames up the stack.

Inputs: frameIndex.

getStatusA

Non-blocking: return current connection and pause state immediately without waiting. Use this to poll for pause instead of waitForPause when the MCP client has a short request timeout (e.g. MCP Inspector ~10s). Returns: connected, paused, targetUrl, pauseReason, hitBreakpoints, callStack.

Inputs: no named parameters.

launchChromeA

[STEP 1] Launch a dedicated Chrome instance with remote debugging enabled (default port 9222). Uses --user-data-dir=~/.chrome-debug-profile so your normal Chrome keeps running (dual-instance). Auto-detects if the debug port is already active and skips launch (alreadyRunning=true). Use dryRun=true to preview the command — show it to the user and ask for confirmation before executing. Set openDevTools=true to automatically open DevTools panel for every new tab. If automatic launch does not succeed, relay the returned command to the user and ask them to run it manually. Relay the "_ui" field from the response to the user.

Inputs: url, port, dryRun, chromePath, +2 more.

listTargetsA

[STEP 2] List all open Chrome tabs available for debugging. MANDATORY: show the full list to the user and ask "Which URL do you want to debug?" NEVER skip this step, NEVER guess — even if only one tab is open. Wait for the user's explicit reply before proceeding to connect(). Relay the "_ui" field from the response to the user.

Inputs: port.

reloadPageA

[STEP 5a] Reload the connected page via Chrome DevTools Protocol. More reliable than manual browser refresh — maintains the CDP connection and ensures debugger; statements and setBreakpoint() calls resolve correctly when scripts reload. Always call this after inserting debugger; in source code or after setBreakpoint(), before waitForSpecificPause/waitForPause.

⚠️ CRITICAL TURN RULE: After this tool returns, you MUST immediately call waitForSpecificPause (or waitForPause) in the SAME AI turn — do NOT end your turn here. waitForSpecificPause is a blocking call that will notify the user to trigger the page action and wait for the breakpoint internally. If you end your turn after reloadPage, the session will break.

Inputs: ignoreCache.

removeBreakpointA

Remove a previously set CDP breakpoint by its ID (returned by setBreakpoint).

Inputs: breakpointId (required).

resumeA

[STEP 8] Resume script execution after collecting all needed variable data — ends the current pause. After calling resume, remove all temporary debugger; statements added to source code during this session. Relay the "_ui" field from the response to the user.

Inputs: no named parameters.

setBreakpointA

Set a breakpoint at a specific script URL and line number via CDP — no source code modification needed. Use a full URL (https://...) for exact match, or a partial filename/keyword for regex match. Alternative to inserting debugger; when you cannot modify the source file. After setting, call reloadPage() to ensure the breakpoint resolves correctly.

Inputs: url (required), line (required), column, condition.

startDebuggingSessionA

CALL THIS FIRST whenever browser-side debugging is needed — before any other tool.

Auto-trigger when user mentions any of: debug, breakpoint, debugger, inspect, trace, step through, runtime value, variable value, why is this, implement based on API response, bug, error, unexpected behavior, not working, check this, confirm this.

Returns the complete debugging workflow and critical rules. The response contains a "_ui" field — relay it to the user verbatim.

Inputs: no named parameters.

stepIntoA

[STEP 7] BLOCKING: step into the next function call, then wait until the debugger pauses again. Follow with getScopeVariables() to observe inner-function state.

Inputs: timeout.

stepOutA

[STEP 7] BLOCKING: step out of the current function and wait until the debugger pauses again in the caller. Use to observe the return value and the state of the calling context.

Inputs: timeout.

stepOverA

[STEP 7] BLOCKING: step over the current statement without entering function calls, then wait until the debugger pauses again. Follow with getScopeVariables() to observe how local variables change.

Inputs: timeout.

waitForPauseA

[STEP 5b — FALLBACK] BLOCKING call — waits until ANY debugger pause occurs (breakpoint, debugger; statement, or exception). Before blocking, sends a notification to the user to trigger the page action. Must be called IMMEDIATELY after reloadPage() in the SAME AI turn — do NOT end your turn before calling this. Prefer waitForSpecificPause when you know the exact file and line — it uses smarter two-tier matching. Use this only when the target location is unknown or when setBreakpoint is used without a specific line.

Inputs: timeout, actionHint.

waitForSpecificPauseA

[STEP 5b — PREFERRED] BLOCKING call — waits for the next debugger pause, then checks if it matches the target location.

⚠️ NO AUTO-RESUME: execution stays paused after this returns, regardless of matched value. You decide what to do based on the "matched" field in the response: matched=true → call getScopeVariables() immediately to read variables matched=false → the wrong breakpoint fired; call resume() to continue, then call waitForSpecificPause() again if you need to wait for the next pause.

Must be called IMMEDIATELY after reloadPage() in the SAME AI turn. Before blocking, sends a notification to the user to trigger the page action. Editor line N → pass line=N-1 (CDP uses 0-based line numbers). Relay the "_ui" field from the response to the user once it returns.

Inputs: line (required), urlFragment (required), timeout, actionHint, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 18 tools

    Disambiguation3/5

    Core tools are distinct, but waitForPause vs waitForSpecificPause have heavily overlapping blocking-wait semantics that could easily cause misselection. getScopeVariables vs evaluate also blur boundaries, and startDebuggingSession's auto-trigger instructions create confusion about when the workflow tool is appropriate.

    Naming Consistency4/5

    Consistently camelCase with mostly verb-first names, and the stepInto/stepOver/stepOut family is clean. Minor deviations: 'evaluate' and 'resume' are bare verbs without a resource prefix, and the verb vocabulary is somewhat varied (launch, list, connect, set, force, reload), but no convention mixing.

    Tool Count3/5

    18 tools is in the heavy range, and several could be consolidated (waitForPause/waitForSpecificPause, getStatus overlapping with wait functionality, startDebuggingSession being more of a workflow document than a tool). Not egregiously bloated—each tool does meaningful work—but the set could be trimmed to ~14-15 without losing expressiveness.

    Completeness4/5

    Covers the full debug lifecycle: launch, connect, breakpoints, pause, inspect, step, resume, and status. Minor gaps: no way to list active breakpoints, and the workflow skips STEP 4 entirely. Exception handling is only mentioned tangentially in waitForPause. Otherwise, a well-covered surface that achieves its debugging purpose.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to debug JavaScript and TypeScript applications by connecting to Chrome DevTools Protocol-compatible debuggers, allowing them to set breakpoints, step through code, inspect variables, and evaluate expressions with full source map support.
      18
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Wraps Chrome DevTools Protocol to provide AI agents with low-level browser debugging tools including breakpoints, stack traces, stepping, network interception, and source maps.
      79 npm
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to debug code and automate browsers using Chrome DevTools Protocol, supporting breakpoints, variable inspection, and replayable interaction recording.
      35
      611 npm
      19
      MIT