JS Reverse MCP
JS Reverse MCP
English | 中文
Ein AI-first / AI-natives JavaScript-Reverse-Engineering-MCP-Server, der deinen KI-Coding-Assistenten (wie Claude, Cursor, Copilot) in die Lage versetzt, wie ein Analyst kontinuierlich JavaScript-Verhalten im Browser zu debuggen, zu lokalisieren, zu speichern und nachzuvollziehen.
Es geht nicht darum, die Chrome-DevTools-API unverändert an das Modell weiterzureichen, sondern darum, Skripte, Breakpoints, Netzwerk, WebSocket, Browserzustand und lokale Datei-I/O so zu reorganisieren, dass sie für kontinuierliches Schlussfolgern und Handeln eines KI-Agenten geeignet sind. Anti-Erkennung ist Teil der Fähigkeiten: Standardmäßig wird ein speziell für dieses MCP neu kompilierter und unabhängig gepflegter Patchright-Fork verwendet, der Stealth auf Protokollebene bietet. Für starke Anti-Scraping-Seiten kann optional der CloakBrowser-Quellcode-Ebenen-Fingerabdruckmodus von CloakBrowser aktiviert werden.
☁️ 赞助 · Sponsored by IPWO
IPWO-Wohnproxys unterstützen flexible Proxy-Konfigurationen. Entwickler können je nach Aufgabe die passende Netzwerkumgebung wählen – für Webzugriff, Anfragetests, regionale Inhaltsanalyse und automatisierte Workflows.
Für Projekte mit JS-Reverse-Engineering, Browser-Debugging und Web-Netzwerkanalyse können Wohnproxys auch als ergänzende Netzwerkumgebungsoption dienen und Entwicklern helfen, Zugriffs- und Testanforderungen in verschiedenen Regionen flexibler zu erfüllen.
👉 Kostenloser Testzugang, 10 % Rabattcode: 0204
Related MCP server: MCP JS Debugger
☁️ 赞助 · Sponsored by Infistar.cc 无限星河
js-reverse-mcp × Infistar.cc 无限星河|Alle Modelle API · Stabiler Antrieb für KI-gestütztes Debugging
Vielen Dank an Infistar.cc 无限星河 für das Sponsoring und die Bereitstellung von Modellservice-Support für js-reverse-mcp!
⚡ Bewältigt komplexe Debugging-Aufgaben stabil: Bietet unternehmensgerechte Hochkonkurrenz-Kanäle und Multi-Node-Redundanz, Preise ab 10 % der offiziellen Kanäle, reduziert Rate-Limits, 429-Fehler und Verbindungsabbrüche bei langen Aufgaben.
🧠 Ein API-Key für gängige Modelle: Unterstützt ChatGPT, Claude, Gemini, Kimi, GLM, DeepSeek und andere Modelle, kompatibel mit Claude Code, Codex, Cursor und anderen KI-Programmiertools.
🔎 Unterstützt autorisiertes Debugging und Sicherheitsforschung: Geeignet für mehrstufige Aufgaben wie Skriptsuche, Breakpoint-Analyse, Netzwerkanfrage-Tracking, Call-Stack-Prüfung und Code-Logik-Verständnis.
📦 Exklusives Benefit für Projektnutzer: Über den exklusiven Partnerlink registrieren und den ersten Aufruf abschließen, um ein Testguthaben im Wert von 5 USD / ein exklusives Erstauflade-Angebot zu erhalten.
Positionierung: Unterstützung für Claude Code / Codex Modell-API-Konfiguration.
Funktionen
AI-native Tool-Design: Tool-Granularität, Ausgabegrenzen und Fehlermeldungen sind alle auf Agent-Entscheidungen ausgelegt, um das Modell nicht in ineffektive nächste Schritte zu treiben
Nachvollziehbare Workflows: Skriptquellcode, rohe Netzwerkdaten und Binärergebnisse können in lokale Dateien exportiert und als Eingabe für spätere Analysen verwendet werden
Breakpoint-Kontext-Ausführung: Beim Pausieren kann direkt im Call Frame ausgewertet, auf Scope-Variablen geprüft, schrittweise ausgeführt und der Quellcode-Kontext zurückgegeben werden
Skriptanalyse: Alle geladenen JS-Dateien auflisten, Code durchsuchen, Quellcode abrufen/speichern, große komprimierte Skripte automatisch formatieren
Netzwerk- und WebSocket-Analyse: Request-Call-Stacks, XHR-Breakpoints, Set-Cookie-Erkennung, Export von rohen Body/Header-Daten, WebSocket-Nachrichtengruppierung
Browserzustand-Wiedergabe: Cookies / Cache / Storage / sessionStorage der aktuellen Site bereinigen, kombiniert mit Reload zur Reproduktion von Cookie- und Risikokontroll-Abläufen
Standardmäßig mit Fenster + persistenter Login-Sitzung: Browser sichtbar, Cookies / localStorage bleiben über Sitzungen hinweg erhalten
Spezieller Patchright-Kern: Standardmäßig abhängig von einem unabhängig gepflegten Patchright-Fork dieses Projekts, der kontinuierlich bekannte Shared-Implementation-Merkmale des Upstreams behebt
Optionale Anti-Erkennungsschicht: Spezielles Patchright-Stealth auf Protokollebene standardmäßig aktiviert; für starke Anti-Scraping-Seiten kann
--cloakmit CloakBrowser-Binärdatei hinzugefügt werden
Spezieller Patchright-Fork
js-reverse-mcp hängt nicht mehr direkt vom allgemeinen Patchright-Veröffentlichungspaket ab, sondern verwendet das speziell für dieses MCP kompilierte und veröffentlichte @zhizhuodemao/patchright. Dieser Fork wird in einem separaten Repository kontinuierlich gepflegt und entwickelt sich mit den tatsächlichen Erkennungsmustern dieses MCP weiter.
Keine direkte Abhängigkeit mehr vom allgemeinen Patchright-Veröffentlichungspaket
Anpassungen auf Protokollebene für bestätigte Shared-Implementation-Merkmale des Upstreams, neu kompiliert und veröffentlicht
Anti-Erkennungsanpassungen hängen nicht von JS-Injektion auf Seitenebene ab
Behält ursprüngliche Fähigkeiten wie evaluate, locator und Seitensteuerung bei
Der Fork wird kontinuierlich im speziellen Repository für dieses MCP gepflegt
Die öffentliche Dokumentation erläutert nur die Designgrenzen, nicht die internen Erkennungsmuster und Implementierungsdetails. Das Ziel des speziellen Forks ist es, bestätigte Shared-Implementation-Merkmale zu reduzieren, nicht eine absolute Nicht-Erkennbarkeit der Browserautomatisierung zu versprechen.
Systemanforderungen
Schnellstart (npx)
Keine Installation erforderlich, direkt in der MCP-Client-Konfiguration hinzufügen:
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
}
}
}Claude Code
claude mcp add js-reverse npx js-reverse-mcpWenn du noch kein nutzbares Modell-API hast oder eine benutzerdefinierte API-Adresse konfigurieren möchtest, findest du hier eine Anleitung: Claude Code / Codex Drittanbieter-Modell-API-Konfigurations-Tutorial.
Codex
codex mcp add js-reverse -- npx js-reverse-mcpWenn du noch kein nutzbares Modell-API hast oder eine benutzerdefinierte API-Adresse konfigurieren möchtest, findest du hier eine Anleitung: Claude Code / Codex Drittanbieter-Modell-API-Konfigurations-Tutorial.
Cursor
Gehe zu Cursor Settings -> MCP -> New MCP Server und verwende die obige Konfiguration.
VS Code Copilot
code --add-mcp '{"name":"js-reverse","command":"npx","args":["js-reverse-mcp"]}'Lokale Installation (optional)
git clone https://github.com/zhizhuodemao/js-reverse-mcp.git
cd js-reverse-mcp
npm install
npm run buildDann in der MCP-Konfiguration den lokalen Pfad verwenden:
{
"mcpServers": {
"js-reverse": {
"command": "node",
"args": ["/你的路径/js-reverse-mcp/build/src/index.js"]
}
}
}AI-first Design
Das Kernziel dieses Projekts ist nicht „den Browser bedienen zu können", sondern dem KI-Agenten zu ermöglichen, eine echte JS-Reverse-Engineering-Aufgabe stabil abzuschließen: Seite öffnen, Risikokontrolle passieren, Skript lokalisieren, Quellcode speichern, Breakpoints setzen, Verhalten auslösen, Laufzeit prüfen, Netzwerkmaterial exportieren, Zustand reproduzieren und dann weiter schlussfolgern.
Mehrere Designausrichtungen ziehen sich durch den Code:
Tools sind Agent-Primitives, keine DevTools-Menü-Abbildungen:
list_network_requestskann sowohl Indizes auflisten, als auch Details perreqidabfragen und präzise Materialien überoutputFileexportieren;evaluate_scriptkann sowohl auf der Seite ausgeführt werden, als auch im Breakpoint-Call-Frame, und kann Eingaben überlocalFilePathempfangen.Ausgaben müssen den nächsten Schritt leiten: Listenausgaben bleiben kurz und scanbar; Detailausgaben haben Grenzen; lange Ergebnisse weisen auf Export hin; pending Requests weisen klar darauf hin, zuerst die Ausführung fortzusetzen, damit der Agent nicht auf eine Response wartet, die nie kommt.
Lokale Dateien sind die Analyse-Workbench:
save_script_source,list_network_requests(..., outputFile),evaluate_script(..., localFilePath)ermöglichen dem Agenten, zwischen Browser, Netzwerk und lokalen Dateien hin- und herzuwechseln, anstatt große Codeblöcke oder Binärdaten in den Chat-Kontext zu stopfen.Zustand kann bereinigt, Abläufe können wiedergegeben werden: Das Standardprofil behält den Login-Zustand;
--isolatedbietet eine einmalige saubere Umgebung;clear_site_datalöscht nur den zustandsbezogenen Status der aktuellen Site, um Cookie-Erzeugung, Risikokontroll-Initialisierung und Request-Ketten wiederholt zu reproduzieren.Anti-Erkennung dient der Debugging-Kette: CDP-stille Navigation, echtes Viewport, Google-Referer, spezieller Patchright-Fork und CloakBrowser zielen alle darauf ab, dass der Agent in die Zielseite gelangen und die Analyse fortsetzen kann, nicht das Projekt in ein generisches Scraping-Framework zu verwandeln.
Anti-Erkennungsmechanismus (unterstützende Fähigkeit)
Anti-Erkennung ist eine der zugrunde liegenden unterstützenden Fähigkeiten von js-reverse-mcp. Die Wrapper-Schicht (dieses MCP selbst) hat null JS-Injektion und macht keine Object.defineProperty-Hacks (das wäre selbst ein Erkennungssignal). Alle Anti-Erkennung erfolgt in zwei sich nicht überlappenden Schichten:
Schicht | Standardmodus |
|
Protokollebene (CDP) | Spezieller Patchright-Fork: ruft | Gleich |
Quellcode-Ebene (C++-Binär-Patch) | Keine – verwendet direkt das System-Google-Chrome | CloakBrowser-Binärdatei (plattformspezifische Quellcode-Ebenen-Fingerabdruck-Patches, abdeckend |
Profilverzeichnis |
|
|
Tatsächlicher Browser | Dein installiertes Google Chrome (mit Web Store, Erweiterungen, Sync) | Benutzerdefinierte Chromium-Kompilierung (ohne Google-Dienste, ohne Web Store) |
Zusätzlich einige Maßnahmen auf Navigationsebene (in beiden Modi wirksam):
CDP-stille Navigation – Bei Seitenladen wird
Network.enable/Debugger.enablenicht aktiviert; Request-/Konsolen-Sammlung läuft nur über Playwright-Listener, bis ein Tool explizit CDP benötigtGoogle-Referer –
new_pagebringt standardmäßigreferer: https://www.google.com/mitEchtes Viewport – Das Playwright-Standard-Fake-Viewport von 1280×720 wird deaktiviert, der Browser zeigt die echte Bildschirmgröße
Wann --cloak aktivieren: Nur wenn das oben Genannte nicht ausreicht und die Site per Fingerabdruck blockiert. Details siehe docs/cloak.md.
Werkzeugliste (24 Stück)
Seite und Navigation
Werkzeug | Beschreibung |
| Offene Seiten auflisten oder per Index den Debugging-Kontext auswählen |
| Neue Seite erstellen und zu URL navigieren |
| Navigieren, zurück, vor oder Seite aktualisieren |
| Alle Frames (iframes) auflisten oder Ausführungskontext auswählen |
| Streng abgleichen und auf ein einzelnes sichtbares Element im aktuellen Frame klicken |
| Seiten-Screenshot aufnehmen |
Skriptanalyse
Werkzeug | Beschreibung |
| Alle im Browser geladenen JavaScript-Skripte auflisten |
| Skriptquellcode-Ausschnitt abrufen, mit Zeilenbereich oder Zeichenoffset |
| Vollständigen Skriptquellcode in lokale Datei speichern (geeignet für große/komprimierte/WASM-Dateien) |
| In allen Skripten nach Zeichenfolge oder regulärem Ausdruck suchen |
Breakpoints und Ausführungssteuerung
Werkzeug | Beschreibung |
| Breakpoint automatisch durch Suche im Code-Text setzen (geeignet für komprimierten Code) |
| XHR/Fetch-Breakpoint nach URL-Muster setzen |
| Breakpoints mit expliziter Aktion nach ID, URL oder alle entfernen |
| Alle aktiven Breakpoints auflisten |
| Pausenzustand, Call-Stack und Scope-Variablen abrufen |
| Mit expliziter Aktion pausieren oder fortsetzen |
| Schrittweises Debugging (over/into/out), gibt Position und Quellcode-Kontext zurück |
Netzwerk und WebSocket
Werkzeug | Beschreibung |
| Netzwerkanfragen auflisten, Details anzeigen oder rohe Materialien wie Header/Body/Query exportieren |
| Nach expliziter Bestätigung gesammelte Requests und Body-Cache der aktuellen Seite leeren |
| JavaScript-Call-Stack einer Netzwerkanfrage abrufen |
| WebSocket-Verbindungen auflisten, Nachrichtenmuster analysieren oder Nachrichtendetails abrufen |
Browserzustand
Werkzeug | Beschreibung |
| Cookies, Origin-Storage und sessionStorage der aktuellen Site bereinigen; globalen HTTP-Cache kann explizit ausgewählt werden |
Inspektionswerkzeuge
Werkzeug | Beschreibung |
| JavaScript auf der Seite oder im Breakpoint-Kontext ausführen, unterstützt Main World, Speichern von Ergebnissen und Lesen einer lokalen Eingabedatei |
| Konsolenmeldungen auflisten oder Einzeldetails per msgid abrufen |
Verwendungsbeispiele
Grundlegender JS-Reverse-Engineering-Ablauf
Zielseite öffnen
打开 https://example.com 并列出所有加载的 JS 脚本Zielfunktion finden
在所有脚本中搜索包含 "encrypt" 的代码Breakpoint setzen
在加密函数入口处设置断点Auslösen und analysieren
在页面上触发操作,断点命中后检查参数、调用栈和作用域变量WebSocket-Protokollanalyse
列出 WebSocket 连接,分析消息模式,查看特定类型的消息内容Vom Agenten empfohlener vollständiger Erfassungsablauf
Da die Navigationsphase bewusst CDP-still gehalten wird, werden beim ersten Betreten der Zielseite die Network-/Debugger-Domänen nicht sofort geöffnet. Empfohlener Ablauf: Erst Risikokontrolle passieren, dann per Refresh erfassen:
1. new_page 打开目标页
2. 调用 list_network_requests 激活 collectors
3. navigate_page(type="reload") 刷新页面
4. 再次 list_network_requests 查看完整请求
5. 对关键 reqid 使用 outputFile 导出原始材料Cookie / Risikokontroll-Wiedergabeablauf
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 在页面上下文中复算或验证Konfigurationsoptionen
Die CLI bleibt schlank, alle Flags sind optional. Für 99 % der Szenarien reicht der Standard. Bei lokalen Dateien wird empfohlen, mit --allowedRoots die Verzeichnisse einzuschränken, die der Agent lesen und schreiben darf.
Option | Beschreibung | Standardwert |
| Auf CloakBrowser-Stealth-Binärdatei umschalten (ersetzt System-Chrome). Aktiviert plattformspezifische C++-Quellcode-Ebenen-Fingerabdruck-Patches. Beim ersten Start werden automatisch ~200MB Binärdateien heruntergeladen; die Fingerabdruck-Identität wird pro Profil persistiert. Details siehe docs/cloak.md. |
|
| Temporäres user-data-dir verwenden (Cookies/localStorage werden nicht behalten, beim Schließen automatisch bereinigt) |
|
| Mit einer bereits laufenden Chrome-Instanz verbinden (CDP-HTTP-Endpunkt, z. B. | – |
| MCP-Debug-Log in normale Datei mit | – |
| Wiederholbar angeben, welche lokalen Verzeichnisse der Agent lesen und schreiben darf; echte Pfade auflösen und Symlink-Ausbrüche ablehnen. Wenn aktiviert, werden | – |
Beispielkonfigurationen
Standard – System-Chrome + persistenter Login-Zustand (für die meisten Debugging-Szenarien empfohlen):
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
}
}
}--cloak – starke Anti-Scraping-Seiten (Cloudflare Turnstile / DataDome / FingerprintJS-Schutz):
Dringend empfohlen: Binärdateien vorab herunterladen (einmalig, ~30–60 Sekunden). Wenn du diesen Schritt nicht machst, lädt der erste Start des MCP mit
--cloakstill ~200MB herunter, was wie ein eingefrorenes MCP aussieht:npx cloakbrowser install(Das
cloakbrowser-Paket wird bereits überoptionalDependenciesmitinstalliert; dieser Befehl löst nur dessen eingebaute Binärdatei-Download-Logik aus, mit Fortschrittsbalken)
{
"mcpServers": {
"js-reverse-cloak": {
"command": "npx",
"args": ["js-reverse-mcp", "--cloak"]
}
}
}Zwei parallele Instanzen – zwei MCP-Instanzen mit physisch getrennten Profilen, je nach Zielseite umschalten:
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
},
"js-reverse-cloak": {
"command": "npx",
"args": ["js-reverse-mcp", "--cloak"]
}
}
}--isolated – jedes Mal ein frisches Profil (Cookies/localStorage werden nicht behalten):
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp", "--isolated"]
}
}
}Mit laufendem Chrome / Drittanbieter-Fingerprint-Browser verbinden
--browserUrl akzeptiert nur CDP-Endpunkte (HTTP-Endpunkte, die auf /json/version antworten), keine herstellerspezifischen privaten Local-APIs. Wie du den CDP-Port bei lokalem Chrome, AdsPower, BitBrowser usw. erhältst, findest du in der speziellen Dokumentation:
📖 docs/cdp-endpoint.md – So erhältst du den CDP-Debugging-Port
Kürzester Weg (lokales 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"]
}
}
}Der CDP-Port von Fingerprint-Browsern (AdsPower, BitBrowser usw.) ändert sich bei jedem Start zufällig. Du musst den Browser zuerst über die herstellerspezifische Local-API starten und dann den Port extrahieren. Die Schritte und Beispielskripte findest du in der oben genannten Dokumentation.
Fehlerbehebung
Von Anti-Scraping-Systemen blockiert
Wenn der Zugriff auf bestimmte Seiten blockiert wird (z. B. Zhihu gibt 40362 zurück, Cloudflare-Challenge-Endlosschleife):
Zuerst
--isolatedprobieren – mit frischem Profil Restzustands-Verschmutzung ausschließen:"args": ["js-reverse-mcp", "--isolated"]Wenn das nicht reicht,
--cloakaktivieren – plattformspezifische Quellcode-Ebenen-Fingerabdruck-Patches aktivieren:"args": ["js-reverse-mcp", "--cloak"]Zuletzt das persistente Profil manuell löschen (Login-Zustand geht verloren):
rm -rf ~/.cache/chrome-devtools-mcp/chrome-profile
Wann --cloak aktiviert werden sollte und wann nicht, findest du in docs/cloak.md.
Agent-Routing-Evaluation (Maintainer)
npm run eval:routing:validate prüft offline die tatsächliche MCP-tools/list, Server-Instructions und die 30 Tool-Auswahl-Verträge in evals/tool-routing.json; dieser Befehl greift nicht auf Modell-Endpunkte zu und ist in den Presubmit aufgenommen.
Die echte Modell-Evaluation ist explizit opt-in und ruft einzeln OpenAI-kompatible Chat-Completions-Endpunkte auf, was Kosten verursachen kann:
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 kann bei lokalen Endpunkten ohne Authentifizierung weggelassen werden; Remote-Endpunkte mit Anmeldedaten müssen HTTPS verwenden, HTTP ist nur für Loopback erlaubt. Mit MCP_ROUTING_EVAL_TIMEOUT_MS kann das Timeout für einzelne Requests angepasst werden. Standardmäßig wird 100 % Durchlaufquote verlangt; beim Vergleich über Modelle hinweg kann mit MCP_ROUTING_EVAL_MIN_PASS_RATE ein Schwellenwert in (0, 1] gesetzt werden. Die Evaluation gibt keine API-Keys, Endpunkte oder Fehlerantwort-Bodys von Endpunkten aus.
Sicherheitshinweis
Dieses Tool setzt Browserinhalte dem MCP-Client aus und erlaubt das Prüfen, Debuggen und Ändern beliebiger Daten im Browser. Verwende es nicht auf Seiten mit sensiblen Informationen.
evaluate_script.localFilePath sowie verschiedene outputFile/filePath-Optionen bewirken, dass der MCP-Prozess Dateien auf dem Hostsystem liest oder schreibt. In Produktions- oder gemeinsam genutzten Umgebungen sollte der Zugriff mithilfe eines oder mehrerer --allowedRoots auf ein dediziertes Arbeitsverzeichnis eingeschränkt werden; ohne Konfiguration ist der Zugriffsbereich uneingeschränkt. Nach Aktivierung von --allowedRoots werden auch die Browser-Seiten file:, view-source:file: und filesystem:file: abgelehnt, um zu verhindern, dass Verzeichnisgrenzen durch Browser-Navigation umgangen werden. Falls lokale Seiten debuggt werden müssen, sollte diese Option nur in Sitzungen nicht konfiguriert werden, in denen das Risiko der Offenlegung lokaler Dateien ausdrücklich akzeptiert wird.
Lizenz
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.1646 npm7MIT