caido-screenshot

Caido の Replay のリクエスト/レスポンスペアのフォーマット済みスクリーンショットをキャプチャする MCP サーバーです。Screenshot Mode プラグインを操作して実現します。

Caido にはスクリーンショット API はありません。Screenshot Mode はフロントエンドのみのプラグインで、ブラウザ内で DOM を PNG にレンダリングします。このサーバーは Chrome DevTools Protocol 経由でそれにアクセスし、プラグイン自身のエクスポート機能をクリックして、Electron が保存ダイアログを開く前に生成された画像をインターセプトします。出力はプラグインの実際の出力そのもので、ディスクに直接書き込まれます。

要件

• Node >= 22（組み込みの WebSocket を使用。npm 依存関係はありません）

• Caido デスクトップ版

• Screenshot Mode プラグインが Caido にインストールされていること

• Caido を --remote-debugging-port 付きで起動していること（下記参照）

Related MCP server: MCP Browser Screenshot Server

インストール

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

npm install の手順は不要です。依存関係はありません。

デバッグポート付きで Caido を起動する

プラグインは Caido のウィンドウ内でレンダリングされるため、サーバーはそのウィンドウと通信する必要があります。通常の起動ではポートが閉じているため、すべての呼び出しが失敗します。

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

または手動で:

# 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

すべてを一度に確認:

caido-screenshot doctor

Claude Code で使用する

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

Claude Code を再起動して、次のように依頼するだけです: "screenshot the current Caido replay session"

任意の MCP クライアントで使用する

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

ツール: caido_screenshot

例

サーバーが登録されていれば、ツール名を指定する必要はありません。やりたいことを平易な英語で伝えるだけで、エージェントが適切に処理します。

現在の画面をキャプチャするだけ

screenshot the current Caido replay request

エージェントが caido_screenshot を呼び出し、保存されたパスを返します:

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

リクエストを送信してからキャプチャする

これは一般的な使い方です。公式の Caido MCP サーバー と組み合わせて使用します。そちらがリクエストを送信し、このサーバーが結果をキャプチャします。

send a GET to https://httpbin.org/get in Caido replay and screenshot it

エージェントがリクエストを送信し、返ってきた Replay エントリを展開済みセッションに対応付け、その正確なセッション ID をキャプチャします:

caido_send_request.entryId を caido_list_replay_sessions[].activeEntryId に対応付けます。requestSourceId から新しいセッションを作成しないでください。Caido はリクエストテンプレートをシードしますが、完了したレスポンスはコピーしません。

自分で書いた生のリクエストを送信する

生の HTTP を貼り付けて、次のように依頼します:

send this in Caido replay and screenshot it:

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

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

特定のセッションを選択する

セッションはサイドバーにリクエストラインの名前で表示されます。例: GET /、POST /login など:

screenshot the "POST /login" replay session, stacked

これは caido_screenshot(session: "POST /login") になります。すべてのキャプチャは Side by Side レイアウトで行われます。

確実に動作させるには、セッション ID を使用します:

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

セッションが別のコレクション内や折りたたまれたコレクション内にある場合は、両方を指定します:

screenshot "01 admin create private conversation" from the "OBS AI Assistant IDOR - Fresh Evidence" collection

これは caido_screenshot(collection: "OBS AI Assistant IDOR - Fresh Evidence", session: "01 admin create private conversation") になります。ツールがコレクションを展開してからセッションを選択し、Side by Side でキャプチャします。

注意: caido_send_request はセッション名をリクエストラインから自動生成するため、複数のセッションがすべて GET / という名前になる可能性があります。曖昧さを避けるため、キャプチャ前に Caido 内でセッション名を変更してください。

特定の場所に保存する

screenshot it and save to ~/reports/login-flow.png

Codex から使用する

インタラクティブセッションを開始して、同じように依頼します:

codex
> screenshot the current Caido replay session

Codex は初回に承認を求めます。このツールのプロンプトをスキップするには、~/.codex/config.toml に追加します:

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

codex exec（非インタラクティブ）では動作しません — approval: never が強制され、per-tool 設定に関係なくすべての MCP ツール呼び出しが拒否されます。インタラクティブセッションを使用してください。

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

環境変数

既知の制限事項

これらはプラグイン自体の制限であり、このサーバーの問題ではありません:

• 長いコンテンツは切り詰められます。 Caido のエディタは CodeMirror で、表示されている行のみをレンダリングします。Caido ウィンドウより縦に長いものは DOM に存在せず、キャプチャできません。非常に長いレスポンスは空白になることがあり、その場合サーバーはエラーを返し、ファイルを書き込みません。

• ヘッダーが省略されることがあります。 DOM から画像へのレンダリングで行が省略され、行番号に途切れが生じることがあります。これらの画像は参考用であり、バイト単位で正確な証拠としては扱わないでください。正確さが重要な場合は Caido 自身のリクエストエクスポート機能を使用してください。

• レイアウトは Side by Side に固定されています。 サーバーはレイアウトや配置のオプションを意図的に公開していません。これにより、すべての証拠スクリーンショットが同じレポート対応フォーマットになります。

• スクリーンショットは編集されません。 画面に表示されているもの（Authorization、Cookie、Set-Cookie など）はすべてそのままキャプチャされます。共有する前に必ず確認してください。

• リクエストのみの Replay セッションはデフォルトで拒否されます。 Screenshot Mode は、選択したセッションにレスポンスがない場合、以前のプレビューを保持することがあります。リクエストのみのスクリーンショットを意図している場合にのみ --allow-no-response を渡してください。

トラブルシューティング

ライセンス

MIT