chrome-debugger-mcp
chrome-debugger-mcp
日本語
ブレークポイント駆動の Chrome デバッグのための MCP サーバー。
chrome-debugger-mcp は Chrome DevTools Protocol のプリミティブを MCP ツールとして公開し、AI エージェントが実際の Chrome タブにアタッチし、実行を一時停止し、スコープ値を検査し、現在のコールフレーム内で式を評価し、静的ソースから推測するのではなくランタイムの事実に基づいてコードをステップ実行できるようにします。
これは汎用のブラウザ自動化サーバーではありません。焦点はランタイムデバッグです。
コア機能
ユーザーの明示的な確認後に CDP 経由で実際の Chrome タブにアタッチする
ブレークポイントまたは
debugger;ステートメントで一時停止し、期待する正確な一時停止を待つ一時停止したフレームからローカル、クロージャ、モジュールスコープの値を読み取る
現在のコールフレームで JavaScript を評価し、実行を前方にステップ実行する
クリーンに再開し、エージェントが実際のランタイム値で続行できるようにする
デモ

デモ: エージェントが 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 操作とネットワーク検査に強いですが、ランタイムデバッグには弱いです。このサーバーは、通常 Chrome DevTools で使用する欠けているループを MCP クライアントに提供します: 正しいタブにアタッチし、適切なタイミングで一時停止し、実際の値を検査し、必要に応じてステップ実行し、クリーンに再開します。
また、エージェントのよくあるミスを防ぐガードレールも追加します:
どのタブにアタッチするかを推測する
ランタイム値を検査せずに挙動を結論づける
reloadPage()とwaitForSpecificPause()の間でターンを終了する
要件
ローカルに Google Chrome がインストールされていること
stdio サーバーとツール呼び出しをサポートする MCP クライアント
デバッグしたいアプリケーションへのアクセス
一時的な
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 クライアント向けの推奨フローは次のとおりです:
startDebuggingSession()を呼び出します。launchChrome()を呼び出すか、CDP ポートが開いている既存の Chrome インスタンスを使用します。listTargets()を呼び出し、完全なタブリストをユーザーに表示します。ユーザーが正確なページ URL を確認するのを待ちます。
connect({ targetUrl })を呼び出します。ローカルソースコードに一時的な
debugger;ステートメントを挿入するか、setBreakpoint()を呼び出します。reloadPage()を呼び出します。同じターン内で直ちに
waitForSpecificPause()を呼び出します。getScopeVariables()とevaluate()を呼び出してランタイム値を検査します。必要に応じて
stepInto()、stepOver()、stepOut()でステップ実行します。resume()を呼び出します。ソースコードから一時的な
debugger;ステートメントを削除します。
エージェント作者向けの重要なルール
このサーバーは人間だけでなく、ツールを使用するエージェント向けに設計されています。MCP クライアントに統合する場合は、次のルールを守ってください:
listTargets()をスキップしないでください。タブが1つだけ開いていても、ターゲット URL を推測しないでください。
connect()の前に必ずユーザーの明示的な確認を待ってください。reloadPage()の後、同じターン内で直ちにwaitForSpecificPause()またはwaitForPause()を呼び出してください。ランタイム値を直接検査できる場合は、静的コードから挙動を説明しないでください。
検査後は必ず
resume()を呼び出してください。ソースコードに一時的な
debugger;ステートメントを追加した場合は、終了前に削除してください。
waitForSpecificPause のマッチング方法
waitForSpecificPause は、任意の一時停止を待つよりも信頼性が高いため、推奨される待機プリミティブです。
一時停止のマッチングには2つの戦略を使用します:
URL フラグメントと行番号の許容差
URL フラグメントと
debugger-statement一時停止理由
2番目のパスは、ソースマップ、トランスパイル、バンドルによってコンパイル後の行番号がエディタの行番号からずれる場合に重要です。
ツール呼び出しの例
ローカルの Vite アプリをデバッグするエージェントは、次のようなことを行うかもしれません:
launchChrome({ dryRun: true })launchChrome()listTargets()ユーザーが
http://127.0.0.1:5173を確認するのを待ちますconnect({ targetUrl: "127.0.0.1:5173" })App.jsxにdebugger;を挿入しますreloadPage()waitForSpecificPause({ urlFragment: "App.jsx", line: 62, actionHint: "click the Refetch payloads button" })getScopeVariables()evaluate({ expression: "payload.modules" })resume()
Chrome の起動動作
launchChrome() は専用のプロファイルを使用するため、ユーザーの通常のブラウザセッションには干渉しません。
デフォルト:
リモートデバッグポート:
9222プロファイルディレクトリ:
~/.chrome-debug-profile
想定される Chrome バイナリの場所:
macOS:
/Applications/Google Chrome.app/Contents/MacOS/Google ChromeLinux:
google-chromeWindows:
C:\Program Files\Google\Chrome\Application\chrome.exe
自動起動に失敗した場合、ツールはユーザーが手動で実行できるコマンドを返します。
ローカルプレイグラウンド
このリポジトリには test/ 配下に使い捨てのテストアプリが含まれており、実際のブラウザワークフローに対してデバッガーサーバーを試すことができます。
モックサービスを起動する
cd test/service
node src/server.jsサービスは http://127.0.0.1:3030 で待ち受けます。
Web アプリを起動する
cd test/web
pnpm install
pnpm devWeb アプリは http://127.0.0.1:5173 で実行されます。
一時停止に便利な場所:
test/web/src/App.jsxのloadWorkbench内test/web/src/App.jsxのloadModuleDetail内test/web/src/App.jsxの未完成の詳細セクション周辺
検査する価値のあるランタイムペイロード領域:
summaryCardsmodulesapiContractsnextActionsresponseShape
トラブルシューティング
ターゲットが見つからない
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 基于真实运行时值继续工作
功能演示

演示流程: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:在暂停调用帧中执行 JavaScriptstepInto、stepOver、stepOut:标准单步控制resume:检查完毕后恢复执行getStatus:非阻塞方式查询是否已连接、是否已暂停forcePause:请求在下一条 JavaScript 语句处暂停
推荐工作流
对于 AI 客户端,建议流程是:
调用
startDebuggingSession()。调用
launchChrome(),或直接复用已经开启 CDP 端口的 Chrome。调用
listTargets(),并把完整标签页列表展示给用户。等待用户明确确认要调试的页面 URL。
调用
connect({ targetUrl })。在本地源码插入临时
debugger;,或者调用setBreakpoint()。调用
reloadPage()。在同一轮里立刻调用
waitForSpecificPause()。调用
getScopeVariables()和evaluate()检查运行时值。必要时使用
stepInto()、stepOver()、stepOut()继续跟踪。调用
resume()。删除源码里临时加入的
debugger;。
给 Agent 作者的重要规则
这个服务首先是为会调用工具的 agent 设计的,而不仅仅是给人手动点工具用。接入 MCP 客户端时,建议遵守这些规则:
不要跳过
listTargets()。即使只看到一个标签页,也不要猜测目标 URL。
一定要等用户明确确认后再调用
connect()。调用
reloadPage()后,必须在同一轮里立刻调用waitForSpecificPause()或waitForPause()。能读取运行时值时,不要只根据静态代码解释行为。
检查完之后一定要
resume()。如果向源码里插入了临时
debugger;,结束前要清理掉。
waitForSpecificPause 如何匹配
waitForSpecificPause 是首选的等待工具,因为它比“等待任意暂停”更可靠。
它有两层匹配策略:
URL 片段加行号容差
URL 片段加
debugger-statement暂停原因
第二层匹配对经过 source map、转译、打包后的代码尤其重要,因为编译后的行号可能和编辑器行号不完全一致。
调用序列示例
一个 agent 调试本地 Vite 应用时,调用顺序大致会像这样:
launchChrome({ dryRun: true })launchChrome()listTargets()等用户确认
http://127.0.0.1:5173connect({ targetUrl: "127.0.0.1:5173" })在
App.jsx插入debugger;reloadPage()waitForSpecificPause({ urlFragment: "App.jsx", line: 62, actionHint: "click the Refetch payloads button" })getScopeVariables()evaluate({ expression: "payload.modules" })resume()
Chrome 启动行为
launchChrome() 会使用独立 profile,不会影响用户平时正在用的浏览器会话。
默认值:
远程调试端口:
9222profile 目录:
~/.chrome-debug-profile
默认 Chrome 可执行文件路径:
macOS:
/Applications/Google Chrome.app/Contents/MacOS/Google ChromeLinux:
google-chromeWindows:
C:\Program Files\Google\Chrome\Application\chrome.exe
如果自动启动失败,工具会返回一个可手动执行的命令。
本地 Playground
这个仓库里有一个可丢弃的测试应用,位于 test/ 下,方便你针对真实的浏览器调试流程来调试这个服务器。
启动 mock 服务
cd test/service
node src/server.js服务监听在 http://127.0.0.1:3030。
启动 web app
cd test/web
pnpm install
pnpm devweb 应用运行在 http://127.0.0.1:5173。
适合暂停的地方:
test/web/src/App.jsx的loadWorkbench内test/web/src/App.jsx的loadModuleDetail内test/web/src/App.jsx的未完成 detail 部分附近
值得检查的运行时 payload 区域:
summaryCardsmodulesapiContractsnextActionsresponseShape
故障排查
找不到目标
确保 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
macOS:
/Applications/Google Chrome.app/Contents/MacOS/Google ChromeLinux:
google-chromeWindows:
C:\Program Files\Google\Chrome\Application\chrome.exe
自動起動に失敗した場合、ツールはユーザーが手動で実行できる起動コマンドを返します。
ローカル Playground
リポジトリには、破棄可能なテストアプリが test/ に同梱されています。これを使って、このデバッグ MCP の一連の流れを直接検証できます。
mock service を起動
cd test/service
node src/server.jsサービスは http://127.0.0.1:3030 で待ち受けます。
web app を起動
cd test/web
pnpm install
pnpm devWeb アプリは http://127.0.0.1:5173 で動作します。
ブレークポイントを設定する推奨箇所:
test/web/src/App.jsx内のloadWorkbenchtest/web/src/App.jsx内のloadModuleDetailtest/web/src/App.jsx内の未完成の detail 領域の近く
実行時に確認する価値がある payload フィールド:
summaryCardsmodulesapiContractsnextActionsresponseShape
トラブルシューティング
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 toolsconnectA
[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
Scored across 18 tools
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.
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.
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.
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
Related MCP Connectors
Live browser debugging for AI assistants — DOM, console, network via MCP.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Build, run, debug, test and ship Chrome, Firefox, Edge and Safari extensions from your AI agent.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI coding assistants to control and inspect a live Chrome browser for automation, debugging, performance analysis, network monitoring, and DOM interaction through Chrome DevTools Protocol.Apache 2.0
- AlicenseAqualityDmaintenanceEnables 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.182Apache 2.0
- AlicenseNot gradedqualityCmaintenanceWraps Chrome DevTools Protocol to provide AI agents with low-level browser debugging tools including breakpoints, stack traces, stepping, network interception, and source maps.79 npm1MIT
- AlicenseBqualityBmaintenanceEnables AI agents to debug code and automate browsers using Chrome DevTools Protocol, supporting breakpoints, variable inspection, and replayable interaction recording.35611 npm19MIT