JS Reverse MCP
JS Reverse MCP
English | 中文
AI-first / AI-native の JavaScript リバースエンジニアリング MCP Server。あなたの AI コーディングアシスタント(Claude、Cursor、Copilot など)が、アナリストのように Web ページ内の JavaScript の挙動を継続的にデバッグ、特定、保存、振り返りできるようにします。
これは Chrome DevTools API をそのままモデルに渡すのではなく、スクリプト、ブレークポイント、ネットワーク、WebSocket、ブラウザ状態、ローカルファイル I/O を、AI Agent が連続的に推論・操作しやすいツールとして再構成したものです。アンチ検出はその能力の一部です。デフォルトでは、本 MCP 用に再コンパイル・公開され、独立してメンテナンスされている Patchright fork を使用してプロトコル層の stealth を提供し、強力なアンチクローリングサイトではオプションで CloakBrowser のソースコード層フィンガープリントモードを有効化できます。
☁️ スポンサー · Sponsored by IPWO
IPWO 住宅代理は柔軟なプロキシ設定をサポートしており、開発者はタスクに応じて適切なネットワーク環境を選択できます。Web アクセス、リクエストテスト、地域別コンテンツ分析、自動化ワークフローに利用できます。
JS リバース、ブラウザデバッグ、Web ネットワーク分析に関わるプロジェクトでは、住宅代理もネットワーク環境の補完的な選択肢として、さまざまな地域のアクセス・テストニーズに柔軟に対応するのに役立ちます。
👉 無料テスト入口、9 割引コード:0204
Related MCP server: MCP JS Debugger
☁️ スポンサー · Sponsored by Infistar.cc 無限星河
js-reverse-mcp × Infistar.cc 無限星河|全モデル API · 安定駆動の AI 支援デバッグ
Infistar.cc 無限星河のスポンサーシップに感謝し、js-reverse-mcp にモデルサービスサポートを提供いただいています!
⚡ 複雑なデバッグタスクを安定的に処理:エンタープライズ級の高並列チャネルとマルチノード冗長化を提供し、価格は公式チャネルの 1 割まで低減。レート制限、429、長時間タスクの切断問題を軽減します。
🧠 1 つの API Key で主要モデルにアクセス:ChatGPT、Claude、Gemini、Kimi、GLM、DeepSeek などのモデルをサポートし、Claude Code、Codex、Cursor などの AI プログラミングツールに対応。
🔎 認可されたデバッグとセキュリティ研究を支援:スクリプト検索、ブレークポイント分析、ネットワークリクエスト追跡、コールスタック検査、コードロジック理解などのマルチステップタスクに適しています。
📦 プロジェクトユーザー限定特典:専用プロモーションリンク から登録して初回呼び出しを完了すると、5 ドル相当のテスト枠 / 初回チャージ限定特典を受け取れます。
位置づけ:Claude Code / Codex モデル API 設定のサポート。
機能特徴
AI-native ツール設計:ツールの粒度、出力境界、エラーメッセージはすべて Agent の意思決定を中心に設計されており、モデルを無効な次のステップに導かないようにします
振り返り可能なワークフロー:スクリプトソースコード、ネットワーク生データ、バイナリ結果をローカルファイルにエクスポートし、その後の分析入力として再利用できます
ブレークポイントコンテキスト実行:一時停止中に call frame 内で直接評価し、スコープ変数を検査し、ステップ実行してソースコードコンテキストを返します
スクリプト分析:読み込まれたすべての JS を一覧表示、コード検索、ソースの取得/保存、大型圧縮スクリプトの自動フォーマット
ネットワークと WebSocket 分析:リクエストコールスタック、XHR ブレークポイント、Set-Cookie 識別、生の body/header エクスポート、WebSocket メッセージのグループ化
ブラウザ状態のリプレイ:現在のサイトの cookies / cache / storage / sessionStorage をクリアし、reload と組み合わせて cookie およびリスク制御フローを再現
デフォルトでヘッドフル + 永続化ログイン状態:ブラウザが見える状態で、cookies / localStorage はセッションをまたいで保持
専用 Patchright カーネル:デフォルトで本プロジェクトが独立してメンテナンスする Patchright fork に依存し、上流の既知の共有実装特徴を継続的に修正
オプションのアンチ検出層:専用 Patchright のプロトコル層 stealth はデフォルトで有効。強力なアンチクローリングサイトでは
--cloakを追加して CloakBrowser バイナリを使用可能
専用 Patchright fork
js-reverse-mcp は Patchright の一般配布パッケージに直接依存せず、本 MCP 専用にコンパイル・公開された @zhizhuodemao/patchright を使用します。この fork は独立したリポジトリで継続的にメンテナンスされ、本 MCP の実際の検出サンプルに合わせて進化します。
Patchright の一般配布パッケージに直接依存しない
確認済みの上流共有実装特徴に対してプロトコル層の調整を行い、再コンパイルして公開
アンチ検出の調整はページレベルの JS 注入に依存しない
evaluate、locator、ページ制御などの元の能力を保持
fork は本 MCP 向けの専用リポジトリで継続的にメンテナンス
公開ドキュメントは設計上の境界のみを説明し、内部の検出サンプルと実装詳細は展開しません。専用 fork の目標は確認済みの共有実装特徴を減らすことであり、ブラウザ自動化が絶対に検出されないことを約束するものではありません。
システム要件
クイックスタート(npx)
インストール不要で、MCP クライアント設定に直接追加します:
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
}
}
}Claude Code
claude mcp add js-reverse npx js-reverse-mcp利用可能なモデル API がない場合、またはカスタム API アドレスを設定する必要がある場合は、Claude Code / Codex サードパーティモデル API 設定チュートリアル を参照してください。
Codex
codex mcp add js-reverse -- npx js-reverse-mcp利用可能なモデル API がない場合、またはカスタム API アドレスを設定する必要がある場合は、Claude Code / Codex サードパーティモデル API 設定チュートリアル を参照してください。
Cursor
Cursor Settings -> MCP -> New MCP Server に移動し、上記の設定を使用します。
VS Code Copilot
code --add-mcp '{"name":"js-reverse","command":"npx","args":["js-reverse-mcp"]}'ローカルインストール(オプション)
git clone https://github.com/zhizhuodemao/js-reverse-mcp.git
cd js-reverse-mcp
npm install
npm run buildその後、MCP 設定でローカルパスを使用します:
{
"mcpServers": {
"js-reverse": {
"command": "node",
"args": ["/你的路径/js-reverse-mcp/build/src/index.js"]
}
}
}AI-first 設計
このプロジェクトの核となる目標は「ブラウザを操作できること」ではなく、AI Agent が実際の JS リバースタスクを安定的に完了できるようにすることです:ページを開く、リスク制御を通過する、スクリプトを特定する、ソースを保存する、ブレークポイントを設定する、挙動をトリガーする、ランタイムを検査する、ネットワーク資料をエクスポートする、状態を再現する、そして推論を続ける。
いくつかの設計方針がコード全体に貫かれています:
ツールは Agent primitives であり、DevTools メニューのマッピングではない:
list_network_requestsはインデックス一覧も、reqidによる詳細照会も、outputFileによる正確な資料エクスポートも可能。evaluate_scriptはページ内での実行も、ブレークポイントの call frame での実行も、localFilePath入力の受け取りも可能。出力は次のステップを導くもの:リスト出力は短くスキャンしやすく保ち、詳細出力には境界があり、長い結果はエクスポートを促し、pending リクエストは実行再開を明確に促し、Agent が完了しない response を待ち続けることを防ぎます。
ローカルファイルは分析ワークベンチ:
save_script_source、list_network_requests(..., outputFile)、evaluate_script(..., localFilePath)により、Agent はブラウザ、ネットワーク、ローカルファイルの間を行き来でき、長大なコードやバイナリデータをチャットコンテキストに詰め込む必要がありません。状態はクリア可能、フローはリプレイ可能:デフォルト profile はログイン状態を保持。
--isolatedは使い捨てのクリーン環境を提供。clear_site_dataは現在のサイト関連の状態のみをクリアし、cookie 生成、リスク制御初期化、リクエストチェーンの反復再現に使用します。アンチ検出はデバッグチェーンに奉仕する:CDP サイレントナビゲーション、実視口、Google referer、専用 Patchright fork、CloakBrowser の目標はすべて、Agent がターゲットページに入って分析を続けられるようにすることであり、プロジェクトを汎用クローラーフレームワークにすることではありません。
アンチ検出メカニズム(基盤能力)
アンチ検出は js-reverse-mcp の基盤能力の 1 つです。ラッパー層(この MCP 自体)はゼロ JS 注入で、Object.defineProperty hack は行いません(それ自体が検出シグナルです)。すべてのアンチ検出は互いに重複しない 2 つの層で行われます:
層 | デフォルトモード |
|
プロトコル層(CDP) | 専用 Patchright fork: | 同 |
ソースコード層(C++ バイナリパッチ) | なし —— システムの Google Chrome を直接使用 | CloakBrowser バイナリ(プラットフォーム別のソースコード層フィンガープリントパッチを提供。 |
Profile ディレクトリ |
|
|
実際のブラウザ | インストール済みの Google Chrome(Web Store、拡張機能、sync 付き) | カスタム Chromium コンパイル版(Google サービスなし、Web Store なし) |
さらにいくつかのナビゲーションレベルの対策(両モードで有効):
CDP サイレントナビゲーション —— ページ読み込み時に
Network.enable/Debugger.enableをアクティブにせず、リクエスト/コンソール収集は Playwright リスナーのみを経由し、ツールが明示的に CDP を必要とするまでアクティブにしないGoogle Referer ——
new_pageはデフォルトでreferer: https://www.google.com/を付与実視口 —— Playwright デフォルトの 1280×720 の偽視口を無効化し、ブラウザは実際の画面サイズを表示
--cloak を有効にするタイミング:上記だけでは不十分で、サイトのフィンガープリントでブロックされた場合のみ。詳細は docs/cloak.md を参照。
ツール一覧(24 個)
ページとナビゲーション
ツール | 説明 |
| 開いているページを一覧表示、またはインデックスでデバッグコンテキストを選択 |
| 新しいページを作成し URL にナビゲート |
| ナビゲート、戻る、進む、またはページをリフレッシュ |
| すべての frame(iframe)を一覧表示、または実行コンテキストを選択 |
| 厳密マッチで現在の frame 内の単一の可視要素をクリック |
| ページのスクリーンショットを撮影 |
スクリプト分析
ツール | 説明 |
| ページに読み込まれたすべての JavaScript スクリプトを一覧表示 |
| スクリプトソースの断片を取得。行範囲または文字オフセットをサポート |
| 完全なスクリプトソースをローカルファイルに保存(大型/圧縮/WASM ファイルに適しています) |
| すべてのスクリプトで文字列または正規表現を検索 |
ブレークポイントと実行制御
ツール | 説明 |
| コードテキスト検索による自動ブレークポイント設定(圧縮コードに適しています) |
| URL パターンによる XHR/Fetch ブレークポイント設定 |
| 明示的な action で ID、URL、またはすべてのブレークポイントを削除 |
| すべてのアクティブなブレークポイントを一覧表示 |
| 一時停止状態、コールスタック、スコープ変数を取得 |
| 明示的な action で実行を一時停止または再開 |
| ステップ実行(over/into/out)、位置とソースコードコンテキストを返す |
ネットワークと WebSocket
ツール | 説明 |
| ネットワークリクエストの一覧表示、詳細表示、または header/body/query などの生資料のエクスポート |
| 明示的な確認後、現在のページで収集されたリクエストと body cache をクリア |
| ネットワークリクエストの JavaScript コールスタックを取得 |
| WebSocket 接続の一覧表示、メッセージパターンの分析、またはメッセージ詳細の取得 |
ブラウザ状態
ツール | 説明 |
| 現在のサイト関連の cookies、origin storage、sessionStorage をクリア。グローバル HTTP cache のクリアは明示的に選択可能 |
検査ツール
ツール | 説明 |
| ページまたはブレークポイントコンテキストで JavaScript を実行。メインワールド、結果保存、ローカル入力ファイルの読み取りをサポート |
| コンソールメッセージの一覧表示、または msgid による単一詳細の取得 |
使用例
JS リバース基本フロー
ターゲットページを開く
打开 https://example.com 并列出所有加载的 JS 脚本ターゲット関数を探す
在所有脚本中搜索包含 "encrypt" 的代码ブレークポイントを設定
在加密函数入口处设置断点トリガーして分析
在页面上触发操作,断点命中后检查参数、调用栈和作用域变量WebSocket プロトコル分析
列出 WebSocket 连接,分析消息模式,查看特定类型的消息内容Agent 推奨の完全キャプチャフロー
ナビゲーション段階では意図的に CDP をサイレントに保つため、初回のターゲットページ進入時には Network / Debugger ドメインはすぐには開かれません。推奨フローは、まずリスク制御を通過してから、リフレッシュしてキャプチャします:
1. new_page 打开目标页
2. 调用 list_network_requests 激活 collectors
3. navigate_page(type="reload") 刷新页面
4. 再次 list_network_requests 查看完整请求
5. 对关键 reqid 使用 outputFile 导出原始材料Cookie / リスク制御リプレイフロー
1. clear_site_data(confirm=true) 清理当前站点状态
2. navigate_page(type="reload") 重新触发初始化
3. list_network_requests 找到设置 cookie 或提交 sensor 的请求
4. 导出 requestBody / responseHeaders / responseBody
5. 用 evaluate_script + localFilePath 在页面上下文中复算或验证設定オプション
CLI は簡潔に保たれ、すべての flag はオプションです。99% のシナリオではデフォルトで十分です。ローカルファイルを扱う場合は、--allowedRoots で Agent が読み書きできるディレクトリを制限することをお勧めします。
オプション | 説明 | デフォルト値 |
| CloakBrowser ステルスバイナリに切り替え(システム Chrome の代わり)。プラットフォーム別の C++ ソースコード層フィンガープリントパッチを有効化。初回起動時に ~200MB のバイナリを自動ダウンロード。フィンガープリント ID は profile ごとに永続化。詳細は docs/cloak.md を参照。 |
|
| 一時的な user-data-dir を使用(cookies/localStorage は保持されず、終了時に自動クリーンアップ) |
|
| 実行中の Chrome インスタンスに接続(CDP HTTP エンドポイント、例: | – |
|
| – |
| Agent が読み書きできるローカルディレクトリを繰り返し指定可能。実パスを解決し、シンボリックリンクによる境界外アクセスを拒否。有効時は | – |
設定例
デフォルト —— システム Chrome + 永続化ログイン状態(ほとんどのデバッグシナリオで推奨):
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
}
}
}--cloak —— 強力なアンチクローリングサイト(Cloudflare Turnstile / DataDome / FingerprintJS 対策):
強く推奨:先にバイナリを事前ダウンロードしてください(1 回限り、~30–60 秒)。これをしない場合、
--cloak付きで MCP を初回起動すると ~200MB をサイレントにダウンロードし、MCP がフリーズしたように見えます:npx cloakbrowser install(
cloakbrowserパッケージはoptionalDependencies経由で一緒にインストール済みです。このコマンドはその内蔵バイナリダウンロードロジックをトリガーするだけで、プログレスバーが表示されます)
{
"mcpServers": {
"js-reverse-cloak": {
"command": "npx",
"args": ["js-reverse-mcp", "--cloak"]
}
}
}2 セット並行 —— 2 つの MCP インスタンスの profile を物理的に分離し、ターゲットサイトに応じて切り替え:
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
},
"js-reverse-cloak": {
"command": "npx",
"args": ["js-reverse-mcp", "--cloak"]
}
}
}--isolated —— 毎回新しい profile(cookies/localStorage を保持しない):
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp", "--isolated"]
}
}
}実行中の Chrome / サードパーティフィンガープリントブラウザに接続
--browserUrl は CDP endpoint(/json/version に応答する HTTP エンドポイント)のみを受け付け、ベンダー独自の Local API は受け付けません。ローカル Chrome、AdsPower、BitBrowser などのシナリオで CDP ポートを取得する方法は、専用ドキュメントを参照してください:
📖 docs/cdp-endpoint.md —— CDP デバッグポートの取得方法
最短パス(ローカル Chrome):
# 先关掉所有 Chrome 窗口,然后
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
--remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp", "--browserUrl", "http://127.0.0.1:9222"]
}
}
}フィンガープリントブラウザ(AdsPower、BitBrowser など)の CDP ポートは起動のたびにランダムに変化するため、ベンダーの Local API でブラウザを起動してから抽出する必要があります。手順とサンプルスクリプトは上記のドキュメントにあります。
トラブルシューティング
アンチクローリングシステムにブロックされた場合
一部のサイトにアクセスしてブロックされた場合(知乎の 40362、Cloudflare チャレンジの無限ループなど):
まず
--isolatedを試す —— 新しい profile で残留状態の汚染を排除:"args": ["js-reverse-mcp", "--isolated"]それでもダメなら
--cloakを有効化 —— プラットフォーム別のソースコード層フィンガープリントパッチを有効化:"args": ["js-reverse-mcp", "--cloak"]最後に永続化 profile の手動クリアを検討(ログイン状態が失われます):
rm -rf ~/.cache/chrome-devtools-mcp/chrome-profile
--cloak を有効にするべきタイミング、すべきでないタイミングの詳細は docs/cloak.md を参照してください。
Agent ルーティング評価(メンテナー向け)
npm run eval:routing:validate は、実際の MCP tools/list、server instructions と evals/tool-routing.json の 30 件のツール選択契約をオフラインで検証します。このコマンドはモデルエンドポイントにアクセスせず、presubmit に組み込まれています。
実際のモデル評価は明示的な opt-in で、OpenAI-compatible Chat Completions エンドポイントを 1 件ずつ呼び出し、費用が発生する可能性があります:
MCP_ROUTING_EVAL_ENDPOINT=https://api.example.com/v1/chat/completions \
MCP_ROUTING_EVAL_MODEL=model-name \
MCP_ROUTING_EVAL_API_KEY=secret \
npm run eval:routingMCP_ROUTING_EVAL_API_KEY は認証不要のローカルエンドポイントでは省略可能。資格情報付きのリモートエンドポイントは HTTPS を使用する必要があり、HTTP は loopback のみ許可されます。MCP_ROUTING_EVAL_TIMEOUT_MS で単一リクエストのタイムアウトを調整できます。デフォルトでは 100% の合格率を要求し、モデル間比較時には MCP_ROUTING_EVAL_MIN_PASS_RATE で (0, 1] の閾値を設定できます。評価は API key、エンドポイント、エンドポイントのエラーレスポンス本文を出力しません。
セキュリティ注意事項
このツールはブラウザのコンテンツを MCP クライアントに公開し、ブラウザ内のあらゆるデータの検査、デバッグ、変更を許可します。機密情報を含むページでは使用しないでください。
evaluate_script.localFilePath、各種 outputFile/filePath は、MCP プロセスがホストマシンのファイルを読み書きする原因となります。本番環境や共有環境では、1つ以上の --allowedRoots を使用して専用の作業ディレクトリに限定する必要があります。未設定の場合、アクセス範囲は無制限となります。--allowedRoots を有効にすると、file:、view-source:file:、filesystem:file: のブラウザページも拒否され、ブラウザのナビゲーションによるディレクトリ境界の迂回を防ぎます。ローカルページのデバッグが必要な場合は、ローカルファイルの露出リスクを明確に受け入れるセッションでのみ、このオプションを設定しないでください。
ライセンス
Apache-2.0
Available Tools
24 toolsbreak_on_xhrA
Sets a URL-substring breakpoint for a future XHR/Fetch when runtime request arguments, local variables, or payload construction must be inspected. For an already captured request, call get_request_initiator first because it is non-pausing; use this only when that evidence is insufficient. Set it before reproducing the user action—it does not inspect past traffic—then call get_paused_info/evaluate_script and finally step or resume. The URL pattern identifies this breakpoint for list_breakpoints and remove_breakpoint(action="remove_xhr").
Inputs: url (required). Returns: ok, data, tool, error, +1 more
clear_network_requestsADestructiveIdempotent
Discard captured HTTP(S) evidence for the currently selected page after confirm=true. Use this immediately before reproducing an action when a clean network capture window is needed; do not use it to reset login, cookies, cache, or other browser state. It irreversibly clears the in-memory request queue, cached response bodies, and initiator maps only. Browser cookies, HTTP cache, origin storage, console messages, and WebSocket connections/messages are unchanged; use clear_site_data for cookie and storage reset. New captures continue above the previous reqid high-water mark because reqids are never reused.
Inputs: confirm. Returns: ok, data, tool, error, +1 more
clear_site_dataADestructiveIdempotent
Irreversibly clear browser state after confirm=true to create a clean replay environment for the selected page. Use this before replaying login, session creation, storage initialization, or other state-dependent flows; do not use it to inspect cookies or determine which response set one. For cookie provenance, including HttpOnly, Secure, and SameSite attributes, use list_network_requests with cookieName first. Cleanup covers cookies affecting the selected page's HTTP(S) frames—including HttpOnly and Secure cookies through the browser context—persistent storage for those frame origins, and each HTTP(S) frame's sessionStorage. It does not reload the page. The browser HTTP cache is global and is preserved by default; set clearBrowserCache=true only when that wider cross-page effect is explicitly intended.
Inputs: confirm, clearBrowserCache. Returns: ok, data, tool, error, +1 more
click_elementADestructive
Performs one verified, auditable click in the currently selected frame. Use it when the task requires activating a known button, link, or control after selecting the correct page/frame and identifying a CSS selector; it is the preferred minimal interaction primitive over arbitrary evaluate_script code. It does not discover elements, type text, or silently guess among matches: the selector must resolve to exactly one element unless index is explicit, and the chosen element must be visible. A click can submit data, navigate, or trigger external effects, so confirm=true is required and the result reports the exact resolved element.
Inputs: selector (required), index, button, confirm, +2 more. Returns: ok, data, tool, error, +1 more
evaluate_scriptADestructive
Evaluates one focused JavaScript function for DOM/page state, web storage, page-defined globals, a paused-frame expression, or browser-side processing of one local file. Use it when those runtime values are the goal and no narrower evidence tool applies. Do not use document.cookie or page evaluation to investigate HttpOnly/Secure cookies, Set-Cookie provenance, or captured HTTP evidence; use list_network_requests with cookieName/reqid, and use search_in_sources/get_script_source for source discovery. While running, evaluation uses the selected frame's isolated world by default or its page main world with mainWorld=true; while paused, it always uses the chosen call frame and ignores mainWorld. Call get_paused_info before paused evaluation, then step or resume when finished. Arbitrary code can change page/external state and requires confirm=true; inline results are bounded, so use outputFile for exact large or binary results.
Inputs: function (required), confirm, mainWorld, frameIndex, +3 more. Returns: ok, data, tool, error, +1 more
get_paused_infoARead-only
Inspects the current call stack, source locations, and selected call-frame scopes after a code/XHR breakpoint or explicit pause has stopped execution. It neither creates a pause nor resumes one. Returned frameIndex values and callFrameIds belong only to the current pause and expire after any step or resume; use evaluate_script with frameIndex for a focused expression, then step or pause_or_resume(action="resume").
Inputs: frameIndex, includeScopes, maxScopeDepth. Returns: ok, data, tool, error, +1 more
get_request_initiatorARead-only
Non-pausing first action for tracing which JavaScript initiated a retained HTTP request when CDP initiator evidence was active. Pass the reqid from list_network_requests; because initiator capture starts lazily and is not retroactive, an older request may have no stack—in that case reproduce the action and inspect the new reqid, or set break_on_xhr before reproduction when runtime values are required. If the captured stack identifies the code, inspect its URL/location with get_script_source. If arguments, locals, or a dynamically built payload are still needed, use break_on_xhr, reproduce, then call get_paused_info or evaluate_script before stepping or resuming. This tool only reads retained evidence and does not pause or reproduce the request.
Inputs: requestId (required). Returns: ok, data, tool, error, +1 more
get_script_sourceARead-only
Reads a small source region around a search match, paused location, or known statement without executing or pausing the page. Select by URL when available because URL-backed scripts can be resolved again after navigation; use the debugger-context-scoped scriptId only for current inline/eval scripts. Use line ranges for normal source and offset/length for minified single-line bundles. For a whole, minified, or WASM source, use save_script_source; to observe runtime values next, call set_breakpoint_on_text against the original loaded source.
Inputs: url, length, offset, endLine, +2 more. Returns: ok, data, tool, error, +1 more
get_websocket_messagesARead-only
Inspect captured bidirectional WebSocket connections and frame payloads for the selected page. Use this for WebSocket, socket, live-update, push, streaming, or realtime message flows; use list_network_requests for ordinary HTTP/XHR/fetch traffic and WebSocket upgrade request headers. WebSocket capture starts lazily on this tool's first use and is not retroactive: if the relevant socket already connected or exchanged frames, call this tool once to initialize capture, then reload or reproduce the flow. Without wsid it lists connections so you can choose one. With wsid it lists paginated sent/received frames; add show_content=true for payload previews. With wsid and analyze=true it groups frames by payload pattern and returns group IDs and sample frame indices; then use groupId to inspect one pattern. With wsid and frameIndex it returns one retained frame's detailed payload using the stable index shown in frame tables or analysis samples.
Inputs: wsid, analyze, groupId, pageIdx, +6 more. Returns: ok, data, tool, error, +1 more
list_breakpointsARead-only
Inspects code and XHR/Fetch breakpoints managed by this MCP session before reproducing an action or cleaning up debugger state. Returns current code breakpointIds and the exact XHR URL patterns needed by remove_breakpoint; URL-backed definitions are restored after navigation when possible, but a rebuilt debugger session may assign new IDs. This does not show why or where execution is currently paused—use get_paused_info for the active call stack.
Inputs: pageIdx, pageSize. Returns: ok, data, tool, error, +1 more
list_console_messagesARead-only
Inspects console messages and uncaught page errors captured for the selected page. Use it to diagnose runtime failures, warnings, application logs, or values already emitted by page code; use search_in_sources for source text and list_network_requests for HTTP evidence instead. Without msgid it lists messages 20 per page by default, optionally filtered by type or retained navigation history. With msgid it returns one message by its stable ID for focused inspection. Capture begins when this MCP attaches and is not retroactive, so reload or reproduce code that logged before attachment.
Inputs: msgid, types, pageIdx, pageSize, +1 more. Returns: ok, data, tool, error, +1 more
list_network_requestsA
Inspect captured HTTP(S) traffic for the currently selected page. Use this for API calls, request or response headers and bodies, redirects, authentication/session flows, replay or signing inputs, and determining which response created, refreshed, rotated, overwritten, or deleted a cookie. Without reqid it lists and filters requests; with cookieName it traces exact response Set-Cookie updates oldest-first, including cookies with HttpOnly, Secure, or SameSite attributes that page JavaScript cannot fully inspect; with reqid it returns bounded request details; with reqid plus outputFile it exports exact data. To inspect complete Set-Cookie values and attributes, export outputPart="responseHeaders" for a reqid returned by cookieName mode. cookieName never searches outbound Cookie request headers. Use get_websocket_messages for WebSocket frame payloads; this tool only represents the HTTP upgrade request. Capture begins when this MCP attaches and is not retroactive, so reload or reproduce traffic that occurred earlier. Captures then survive navigation in a 5000-request FIFO queue. List and cookie-flow modes default to 20 items per page; filters combine with AND and multiple values inside one filter combine with OR.
Inputs: reqid, methods, pageIdx, pageSize, +6 more. Returns: ok, data, tool, error, +1 more
list_scriptsARead-only
Discovers JavaScript currently loaded in the selected debugger context—the main frame by default, or the frame chosen with select_frame. Use select_frame first for iframe-specific source/debugger work. Includes external, inline, and eval scripts in that context; if you already know a function name, endpoint, or code literal, use search_in_sources instead. Each result includes a context-scoped scriptId that expires on reload, navigation, or debugger target change and, for external scripts, a URL that is the preferred selector for get_script_source or save_script_source.
Inputs: filter, pageIdx, pageSize. Returns: ok, data, tool, error, +1 more
new_pageA
Opens a separate browser page for a URL, reusing an existing about:blank startup tab when available. Use this when the task needs another tab or should preserve the currently selected page; use navigate_page to change the URL in the existing selected page instead. It waits for DOMContentLoaded, not every background resource, and then makes the opened page the target for later tools. It preserves cookies, storage, cache, and other browser state; use clear_site_data separately when a clean replay is required.
Inputs: url (required), timeout. Returns: ok, data, tool, error, +1 more
pause_or_resumeA
Explicitly requests an immediate pause or resumes an existing paused execution; it never toggles implicitly. Use a code breakpoint or break_on_xhr instead when a specific statement/request should stop, and use get_paused_info before resuming if evidence must be collected. Resuming invalidates current callFrameIds and frame indices.
Inputs: action (required). Returns: ok, data, tool, error, +1 more
remove_breakpointADestructiveIdempotent
Removes a known code breakpoint, XHR/Fetch breakpoint, or every MCP-managed breakpoint after explicit confirmation. Use breakpointId from set_breakpoint_on_text/list_breakpoints for remove_code, or reuse the exact URL pattern from break_on_xhr/list_breakpoints for remove_xhr. Removal does not resume an already paused page; call pause_or_resume(action="resume") separately after inspection.
Inputs: action (required), url, confirm, breakpointId. Returns: ok, data, tool, error, +1 more
save_script_sourceA
Saves one complete JavaScript or WASM source for local inspection when an inline snippet is insufficient, especially for large or minified bundles. Prefer get_script_source for a small known region and search_in_sources to locate text across loaded scripts first. With format=true, destinations using a supported JavaScript/TypeScript extension are formatted by default; other extensions preserve raw source, and formatted line numbers may differ from the live page. Use distinctive text plus the original URL with set_breakpoint_on_text for runtime debugging. The returned filename is the resolved local path, while scriptId remains scoped to the current debugger context.
Inputs: filePath (required), url, format, scriptId, +1 more. Returns: ok, data, tool, error, +1 more
search_in_sourcesARead-only
Finds a known function name, endpoint, string literal, token, or code pattern in JavaScript loaded by the selected debugger context—the main frame by default, or the frame chosen with select_frame. It searches external, inline/eval, and minified sources in that context without executing or pausing the page, returning 1-based lines plus context-scoped scriptIds; URLs are the preferred selectors for URL-backed matches. Use select_frame first for iframe-specific source work, get_script_source for nearby context, save_script_source for a whole bundle, or set_breakpoint_on_text when runtime values are needed. For a known captured request, prefer get_request_initiator before a broad source search.
Inputs: query (required), isRegex, urlFilter, maxResults, +3 more. Returns: ok, data, tool, error, +1 more
select_frameA
Lists or selects frames, including iframes, within the current page. Use it when the target element, page-defined global, script, or execution context may live in an iframe: first list frames, then pass frameIdx before click_element or evaluate_script. Omitting frameIdx lists 20 frames per page without changing context; passing frameIdx changes the shared frame target, with 0 restoring the main frame. It does not switch browser tabs or navigate—use select_page or navigate_page for those actions—and listPageIdx only paginates this listing.
Inputs: frameIdx, pageSize, listPageIdx. Returns: ok, data, tool, error, +1 more
select_pageA
Lists or selects open browser pages. Use it without pageIdx to identify the active page or choose the correct tab before inspecting network traffic, scripts, frames, or console output; pass pageIdx to make one listed page the shared target for later tools. It does not navigate or create pages: use navigate_page to change the selected page's URL and new_page when a separate tab is required. listPageIdx only paginates the page listing and never changes selection.
Inputs: pageIdx, pageSize, listPageIdx. Returns: ok, data, tool, error, +1 more
set_breakpoint_on_textA
Sets a restorable URL-backed breakpoint when distinctive code text is known and its runtime values must be observed. Call it directly when the user already supplies precise text plus any URL/occurrence disambiguation; use search_in_sources/get_script_source first only when the location is unknown or ambiguous. For an API with no known code location, start with list_network_requests and get_request_initiator or use break_on_xhr. On a hit, call get_paused_info, optionally evaluate_script, then step or resume. Returns the current breakpointId for remove_breakpoint; list breakpoints again after a rebuilt debugger session, and note that unnamed inline/eval scripts cannot use this URL breakpoint.
Inputs: text (required), condition, urlFilter, occurrence. Returns: ok, data, tool, error, +1 more
stepA
Advances JavaScript execution by one debugger operation from an existing pause and returns the next stopped call frame with concise source context. Use after get_paused_info or evaluate_script when control flow still needs tracing; it cannot start from running execution. Each advance invalidates prior callFrameIds, so inspect the new pause again as needed, then use pause_or_resume(action="resume") to finish.
Inputs: direction (required). Returns: ok, data, tool, error, +1 more
take_screenshotA
Captures the visual state of the currently selected page. Use it to verify page layout, visible UI state, selector targets, in-page dialogs/modals, or the effect of a navigation/click; it is not a substitute for DOM values, network evidence, or script inspection. By default it returns the visible viewport, while fullPage=true captures the whole document; oversized captures may be saved as a temporary artifact instead of attached. Pass filePath for a reusable local artifact; existing files require confirmOverwrite=true and remain subject to --allowedRoots.
Inputs: format, quality, filePath, fullPage, +1 more. Returns: ok, data, tool, error, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Tools are organized around specific debugging actions, but many overlap in purpose (e.g., multiple breakpoint and pause/resume tools, multiple request inspection tools). While descriptions are precise, an agent could easily confuse which tool to use for a given step, especially with 24 tools.
Most tools follow a verb_noun pattern in snake_case (e.g., clear_network_requests, click_element). A few deviate slightly (e.g., 'break_on_xhr', 'get_paused_info'), but overall the naming is predictable and readable.
24 tools is on the higher side for a focused reverse engineering server. The set is comprehensive but some tools could be merged (e.g., clear_network_requests and clear_site_data are distinct but very similar). Still, each tool has a clear role, so the count is borderline but acceptable.
The tool surface covers all major aspects of JavaScript reverse engineering: network interception, source inspection, breakpoint management, page control, and evaluation. Minor gaps exist (e.g., no direct DOM query tool), but the set is largely complete for its purpose.
Maintenance
Related MCP Connectors
Live browser debugging for AI assistants — DOM, console, network via MCP.
Hosted browser for AI agents: screenshots, post-JS DOM, console, WCAG. No install, no API key.
Build, run, debug, test and ship Chrome, Firefox, Edge and Safari extensions from your AI agent.
Captured web interfaces, screenshots, flows and structured evidence for AI coding agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to debug frontend applications by providing direct access to browser DevTools, React state, DOM inspection, and runtime debugging capabilities. Bridges the gap between AI and complex web applications for autonomous debugging and issue resolution.1MIT
- 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 gradedqualityDmaintenanceProvides comprehensive Chrome browser debugging capabilities including DOM inspection, network monitoring, console logs, JavaScript execution, breakpoint debugging, and screenshot capture for AI-assisted frontend development.5MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to connect to browser DevTools and backend debuggers for full-stack debugging, including frontend console, network, performance, and backend log analysis.1620 npm7MIT