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: Chrome DevTools MCP

☁️ 赞助 · 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 --cloak mit 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

• Node.js v20.19 oder neuer

• Chrome Stable-Version

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-mcp

Wenn 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-mcp

Wenn 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 build

Dann 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_requests kann sowohl Indizes auflisten, als auch Details per reqid abfragen und präzise Materialien über outputFile exportieren; evaluate_script kann sowohl auf der Seite ausgeführt werden, als auch im Breakpoint-Call-Frame, und kann Eingaben über localFilePath empfangen.

• 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; --isolated bietet eine einmalige saubere Umgebung; clear_site_data lö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:

Zusätzlich einige Maßnahmen auf Navigationsebene (in beiden Modi wirksam):

• CDP-stille Navigation – Bei Seitenladen wird Network.enable / Debugger.enable nicht aktiviert; Request-/Konsolen-Sammlung läuft nur über Playwright-Listener, bis ein Tool explizit CDP benötigt

• Google-Referer – new_page bringt standardmäßig referer: https://www.google.com/ mit

• Echtes 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

Skriptanalyse

Breakpoints und Ausführungssteuerung

Netzwerk und WebSocket

Browserzustand

Inspektionswerkzeuge

Verwendungsbeispiele

Grundlegender JS-Reverse-Engineering-Ablauf

1. Zielseite öffnen

打开 https://example.com 并列出所有加载的 JS 脚本

2. Zielfunktion finden

在所有脚本中搜索包含 "encrypt" 的代码

3. Breakpoint setzen

在加密函数入口处设置断点

4. 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.

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 --cloak still ~200MB herunter, was wie ein eingefrorenes MCP aussieht:

npx cloakbrowser install

(Das cloakbrowser-Paket wird bereits über optionalDependencies mitinstalliert; 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):

1. Zuerst --isolated probieren – mit frischem Profil Restzustands-Verschmutzung ausschließen:

   "args": ["js-reverse-mcp", "--isolated"]

2. Wenn das nicht reicht, --cloak aktivieren – plattformspezifische Quellcode-Ebenen-Fingerabdruck-Patches aktivieren:

   "args": ["js-reverse-mcp", "--cloak"]

3. 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:routing

MCP_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