caido-screenshot-mcp

Ein MCP-Server, der formatierte Screenshots von Caido Replay- Request/Response-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 als 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. Das Ergebnis ist die echte Ausgabe des Plugins, direkt auf die Festplatte geschrieben.

Voraussetzungen

Node >= 22 (verwendet das eingebaute WebSocket; es gibt keine npm-Abhängigkeiten)
Caido Desktop
Das Screenshot Mode-Plugin installiert in Caido
Caido gestartet mit --remote-debugging-port (siehe unten)

Related MCP server: MCP Browser Screenshot Server

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

Claude Code neu starten. Dann einfach fragen: "Screenshot der aktuellen Caido-Replay-Sitzung".

Verwendung mit einem beliebigen MCP-Client

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

Tool: `caido_screenshot`

Parameter	Typ	Beschreibung
`out_path`	string	Wohin die PNG gespeichert werden soll. Standard `~/Downloads/caido-screenshot-<timestamp>.png`
`collection`	string	Replay-Sammlung, die die Sitzung enthält. Wird automatisch erweitert.
`session`	string	Replay-Sitzung, die zuerst ausgewählt werden soll, nach Seitenleistenname (z. B. `GET /login`)
`session_id`	string	Exakte Replay-Sitzungs-ID. Bevorzugt, da eindeutig.
`require_response`	boolean	Nur-Request-Sitzungen und veraltete Vorschauen ablehnen. Standard `true`.
`inline`	boolean	Das Bild auch im Ergebnis zurückgeben (groß). Standard `false`.

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, dann erfassen

Das ist der häufige 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:

Schritt	Tool	Server
1	`caido_send_request`	caido
2	`caido_list_replay_sessions`	caido
3	`caido_screenshot(session_id: ...)`	caido-screenshot

Ordne caido_send_request.entryId dem caido_list_replay_sessions[].activeEntryId zu. Erstelle keine neue Sitzung aus requestSourceId für Response-Beweise: Caido befüllt die Request-Vorlage, kopiert aber nicht die abgeschlossene Response.

Eine rohe Anfrage senden, die du geschrieben hast

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 Request-Zeile in der Caido-Seitenleiste benannt, also GET /, POST /login usw.:

Screenshot der "POST /login"-Replay-Sitzung, gestapelt

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

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

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

Wenn die Sitzung in einer anderen oder eingeklappten Sammlung liegt, beide benennen:

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.

Hinweis: caido_send_request benennt Sitzungen automatisch nach der Request-Zeile, 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 in ~/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) funktioniert nicht — es erzwingt approval: never und verweigert alle MCP-Tool-Aufrufe, 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

Variable	Standard	Beschreibung
`CAIDO_CDP_PORT`	`9222`	Caidos Remote-Debugging-Port
`CAIDO_CDP_TIMEOUT_MS`	`45000`	CDP-Timeout pro Aufruf

Bekannte Einschränkungen

Das sind Eigenschaften des Plugins, nicht des 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 herauskommen; der Server gibt einen Fehler aus, statt eine fast leere Datei zu schreiben.
Header können fehlen. Die DOM-zu-Bild-Renderung lässt manchmal Zeilen aus, mit sichtbaren Lücken in den Zeilennummern. Behandle diese Bilder als illustrativ, nicht als bytegenaue Beweise — verwende Caidos eigenen Request-Export, wenn Präzision wichtig ist.
Das Layout ist auf Side by Side festgelegt. Der Server legt bewusst keine Layout- oder Anordnungsoption offen, damit jeder Beweis-Screenshot das gleiche berichtsfertige Format hat.
Screenshots sind nicht redigiert. Was auch immer auf dem Bildschirm ist — Authorization, Cookie, Set-Cookie — wird vollständig erfasst. Vor dem Teilen prüfen.
Nur-Request-Replay-Sitzungen werden standardmäßig abgelehnt. Screenshot Mode kann die vorherige Vorschau behalten, wenn die ausgewählte Sitzung keine Response hat. Verwende --allow-no-response nur, wenn ein Nur-Request-Screenshot beabsichtigt ist.

Fehlerbehebung

Meldung	Ursache
`Cannot reach Caido's debug port`	Caido nicht mit `--remote-debugging-port` gestartet. Beenden und `caido-screenshot launch` ausführen.
`Caido is showing the instance picker`	Klicke Connect auf deiner lokalen Instanz im Caido-Fenster.
`No Screenshot button in the Replay toolbar`	Keine Replay-Sitzung geöffnet, oder das Screenshot-Mode-Plugin ist nicht installiert/aktiviert.
`No Replay collection matching "..."`	Verwende den genauen Sammlungsnamen, der in der Replay-Seitenleiste angezeigt wird.
`No Replay session matching "..."`	Das Tool erweitert `collection`, wenn angegeben, und listet dann die sichtbaren Sitzungsnamen auf, wenn keine exakte Übereinstimmung erscheint.
`has no rendered response`	Die ausgewählte Sitzung wurde aus einer Request befüllt oder ist nicht abgeschlossen. Erfasse die Sitzung, deren `activeEntryId` dem `entryId` des Sendeergebnisses entspricht.
`preview is stale`	Screenshot Mode hat eine andere URL angezeigt. Es wurde nichts gespeichert; erneut mit der befüllten `session_id` versuchen.
`returned an empty image`	Inhalt zu lang zum Rendern. Erfasse eine kürzere Request/Response.

Lizenz

MIT

Wait, I need to check my translation. Let me review a few things:

"Caido" - keep as is
"Screenshot Mode" - keep as is (it's a plugin name)
"Replay" - keep as is (it's a Caido feature name)
"Side by Side" - keep as is (it's a layout name)
"CodeMirror" - keep as is
"Electron" - keep as is
"Chrome DevTools Protocol" - keep as is
"WebSocket" - keep as is
"npm" - keep as is
"MCP" - keep as is
"Claude Code" - keep as is
"Codex" - keep as is
"MIT" - keep as is

I need to make sure I preserve all the GXP placeholders exactly. Let me check my translation... I see I wrote "GXP" instead of "GXP11" in one place. Let me fix that.

Also, I need to check the table structures. The original has tables with specific column counts. Let me make sure I preserve them.

Let me also check the "Known limitations" section - I had a typo "manchilsen" which should be "manchmal". Let me fix that.

Also, I need to check the troubleshooting table - the original has 2 columns (Message, Cause), and I need to make sure I keep the same structure.

Let me also check the "Environment" table - it has 3 columns (Variable, Default, Description).

Let me also check the "Examples" section - the table there has 3 columns (Step, Tool, Server).

Let me also check the "Tool: caido_screenshot" table - it has 3 columns (Parameter, Type, Description).

Let me also check the "Known limitations" section - I had a typo "manitchen" which should be "manchmal". Let me fix that.

Also, I need to check the "G" placeholder - I wrote "GXP" instead of "GXP11". Let me fix that.

Let me also check the "G" placeholder - I wrote "GXP" instead of "GXP11". Let me fix that.

Let me also check the

Install Server

A

license - permissive license

A

quality

B

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

caido_screenshotA

Related MCP Servers

MCP Screenshot Server
Browser Automation Web Scraping
sethbang
A
license
A
quality
A
maintenance
Enables capturing screenshots of web pages and local HTML files through a simple MCP tool interface using Puppeteer with configurable options for dimensions and output paths.
Updated 6 days ago (2026-08-17 11:15 UTC)
2
77
29
Apache 2.0
MCP Browser Screenshot Server
Browser Automation Web Scraping Testing & QA Tools
seabassgonzalez
A
license
A
quality
D
maintenance
Enables AI assistants to capture screenshots of web pages using automated browser sessions. Supports full-page and element-specific screenshots, device simulation, and JavaScript execution for comprehensive web testing and monitoring.
Updated a year ago (2025-08-28 00:50 UTC)
6
10
MIT
Webshot MCP
Browser Automation Web Scraping Multimedia Processing
bingal
A
license
C
quality
D
maintenance
Enables taking screenshots of web pages with support for multiple devices (desktop, mobile, tablet), custom dimensions, full-page capture, and various image formats. Built with Playwright for reliable web page rendering and screenshot generation.
Updated a year ago (2025-09-30 04:08 UTC)
1
MIT
screenshot-mcp
Browser Automation Web Scraping
Rumblingb
A
license
Not graded
quality
C
maintenance
Captures webpage screenshots via ScreenshotOne API, offering desktop, mobile, and element-specific views.
Updated 22 days ago (2026-08-01 08:25 UTC)
1
MIT

View all related MCP servers

Related MCP Connectors

Snapshot Site
Capture screenshots, detect visual regressions between page versions, and analyze with AI.
snapforge
Screenshots, PDFs and Markdown from any URL or HTML for AI agents, via the SnapForge API
Screenshot Scout
Capture screenshots of webpages as images or PDFs with Screenshot Scout.

View all MCP Connectors

caido-screenshot