caido-screenshot-mcp

Ein MCP-Server, der formatierte Screenshots von Caido Replay-Anfrage/Antwort-Paaren erstellt, indem er das Screenshot Mode-Plugin steuert.

Caido hat keine Screenshot-API – Screenshot Mode ist ein reines Frontend-Plugin, das das DOM im Browser zu einem PNG rendert. Dieser Server erreicht es über das Chrome DevTools Protocol, klickt auf den eigenen Export des Plugins und fängt das resultierende Bild ab, bevor Electron einen Speicherdialog öffnen kann. Die Ausgabe ist die echte Ausgabe des Plugins, direkt auf die Festplatte geschrieben.

Anforderungen

• Node >= 22 (verwendet das eingebaute WebSocket; es gibt keine npm-Abhängigkeiten)

• Caido Desktop

• Das Screenshot Mode-Plugin in Caido installiert

• Caido mit --remote-debugging-port gestartet (siehe unten)

Related MCP server: Webshot MCP

Installation

git clone <this-repo> caido-screenshot-mcp
cd caido-screenshot-mcp
npm link            # optional: puts `caido-screenshot` on your PATH

Kein npm install-Schritt – es gibt keine Abhängigkeiten.

Caido mit dem Debug-Port starten

Das Plugin rendert im Fenster von Caido, daher muss der Server mit diesem Fenster kommunizieren. Wenn Caido normal gestartet wird, bleibt der Port geschlossen und jeder Aufruf schlägt fehl.

caido-screenshot launch          # quits nothing; starts Caido with the port open

Oder manuell:

# macOS
open -a Caido --args --remote-debugging-port=9222
# Linux
caido --remote-debugging-port=9222
# Windows
"%LOCALAPPDATA%\Programs\Caido\Caido.exe" --remote-debugging-port=9222

Alles auf einmal prüfen:

caido-screenshot doctor

Verwendung mit Claude Code

claude mcp add caido-screenshot --scope user -- node /absolute/path/to/caido-screenshot-mcp/src/server.mjs

Starte Claude Code neu. Dann frag einfach: "Screenshot der aktuellen Caido-Replay-Sitzung".

Verwendung mit jedem MCP-Client

{
  "mcpServers": {
    "caido-screenshot": {
      "command": "node",
      "args": ["/absolute/path/to/caido-screenshot-mcp/src/server.mjs"]
    }
  }
}

Tool: caido_screenshot

Beispiele

Sobald der Server registriert ist, benennst du das Tool nie. Beschreibe, was du willst, in einfachem Englisch, und der Agent übernimmt es.

Nur das auf dem Bildschirm erfassen

Screenshot der aktuellen Caido-Replay-Anfrage

Der Agent ruft caido_screenshot auf und antwortet mit dem gespeicherten Pfad:

Saved /Users/you/Downloads/caido-screenshot-2026-08-22T13-40-11-002Z.png (438 KB)

Eine Anfrage senden und dann erfassen

Das ist der häufigste Fall. Kombiniere es mit dem offiziellen Caido MCP server, der Anfragen senden kann – dieser Server erfasst das Ergebnis.

sende einen GET an https://httpbin.org/get in Caido Replay und mache einen Screenshot davon

Der Agent sendet die Anfrage, ordnet den zurückgegebenen Replay-Eintrag der befüllten Sitzung zu und erfasst genau diese Sitzungs-ID:

Ordne caido_send_request.entryId dem caido_list_replay_sessions[].activeEntryId zu. Erstelle keine neue Sitzung aus requestSourceId für Antwortnachweise: Caido befüllt die Anfragevorlage, kopiert aber nicht die abgeschlossene Antwort.

Eine selbst geschriebene rohe Anfrage senden

Füge das rohe HTTP ein und sage, was du willst:

sende das in Caido Replay und mache einen Screenshot davon:

POST /post HTTP/1.1
Host: httpbin.org
Content-Type: application/json

{"user":"demo","token":"abc123"}

Eine bestimmte Sitzung auswählen

Sitzungen werden nach der Anfragezeile in der Seitenleiste von Caido benannt, also GET /, POST /login usw.:

Screenshot der Replay-Sitzung "POST /login"

Das wird zu caido_screenshot(session: "POST /login"). Jede Erfassung verwendet Side by Side.

Für zuverlässige Automatisierung verwende die Sitzungs-ID:

caido_screenshot(session_id: "67", require_response: true)

Wenn sich die Sitzung in einer anderen oder eingeklappten Sammlung befindet, benenne beide:

Screenshot von "01 admin create private conversation" aus der Sammlung "OBS AI Assistant IDOR - Fresh Evidence"

Das wird zu caido_screenshot(collection: "OBS AI Assistant IDOR - Fresh Evidence", session: "01 admin create private conversation"). Das Tool erweitert die Sammlung, bevor es die Sitzung auswählt, und erfasst sie Side by Side.

Achtung: caido_send_request benennt Sitzungen automatisch nach der Anfragezeile, sodass mehrere Ziele alle GET / heißen können. Benenne eine Sitzung in Caido um, bevor du sie erfasst, wenn du sie eindeutig referenzieren musst.

An einem bestimmten Ort speichern

Screenshot davon und speichere unter ~/reports/login-flow.png

Verwendung mit Codex

Starte eine interaktive Sitzung und frage auf die gleiche Weise:

codex
> screenshot the current Caido replay session

Codex fragt beim ersten Mal nach Genehmigung. Um die Eingabeaufforderung für dieses Tool zu überspringen, füge zu ~/.codex/config.toml hinzu:

[mcp_servers.caido-screenshot.tools.caido_screenshot]
approval_mode = "auto"   # auto | prompt | writes | approve

codex exec (nicht interaktiv) wird nicht funktionieren – es erzwingt approval: never und lehnt alle MCP-Tool-Aufrufe ab, unabhängig von den Einstellungen pro Tool. Verwende eine interaktive Sitzung.

CLI

caido-screenshot                                   # current session -> ~/Downloads
caido-screenshot shot.png                          # explicit path
caido-screenshot shot.png --session "GET /login"
caido-screenshot shot.png --session-id 67
caido-screenshot shot.png --collection "Fresh Evidence" --session "01 admin request"
caido-screenshot doctor
caido-screenshot launch

Umgebung

Bekannte Einschränkungen

Das sind Eigenschaften des Plugins, nicht dieses Servers:

• Langer Inhalt wird abgeschnitten. Caidos Editoren sind CodeMirror, das nur die sichtbaren Zeilen rendert. Alles, was höher als das Caido-Fenster ist, ist nicht im DOM und kann nicht erfasst werden. Sehr lange Antworten können leer erscheinen; der Server meldet einen Fehler, anstatt eine fast leere Datei zu schreiben.

• Header können fehlen. Das DOM-zu-Bild-Rendering lässt manchmal Zeilen aus, mit sichtbaren Lücken in den Zeilennummern. Behandle diese Bilder als illustrativ, nicht als bytegenauen Beweis – verwende Caidos eigenen Anfrage-Export, wenn es auf Präzision ankommt.

• Das Layout ist auf Side by Side festgelegt. Der Server bietet bewusst keine Layout- oder Anordnungsoption an, damit jeder Beweis-Screenshot das gleiche berichtsfertige Format hat.

• Screenshots sind nicht geschwärzt. Was auch immer auf dem Bildschirm ist – Authorization, Cookie, Set-Cookie – wird vollständig erfasst. Prüfe vor dem Teilen.

• Reine Anfrage-Replay-Sitzungen werden standardmäßig abgelehnt. Screenshot Mode kann seine vorherige Vorschau behalten, wenn die ausgewählte Sitzung keine Antwort hat. Verwende --allow-no-response nur, wenn ein reiner Anfrage-Screenshot beabsichtigt ist.

Fehlerbehebung

Lizenz

MIT