caido-screenshot-mcp

MCP-сервер, который делает форматированные скриншоты пар запрос/ответ из Caido Replay, управляя плагином 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: Webshot MCP

Установка

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 порт остаётся закрытым, и все вызовы будут завершаться ошибкой.

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. Затем просто попросите: "сделай скриншот текущей сессии Caido replay".

Использование с любым MCP-клиентом

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

Инструмент: caido_screenshot

Примеры

После регистрации сервера вам не нужно называть инструмент по имени. Опишите желаемое простым языком — агент сам подберёт нужный вызов.

Просто захватить то, что на экране

сделай скриншот текущего запроса Caido replay

Агент вызывает caido_screenshot и отвечает сохранённым путём:

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

Отправить запрос, затем захватить его

Это самый частый сценарий. Объедините его с официальным Caido MCP server, который умеет отправлять запросы — этот сервер захватывает результат.

отправь GET на https://httpbin.org/get в Caido replay и сделай скриншот

Агент отправляет запрос, сопоставляет возвращённую запись Replay с заполненной сессией и захватывает именно этот ID сессии:

Сопоставьте caido_send_request.entryId с caido_list_replay_sessions[].activeEntryId. Не создавайте новую сессию из requestSourceId для доказательства ответа: Caido заполняет шаблон запроса, но не копирует завершённый ответ.

Отправить написанный вами сырой запрос

Вставьте сырой HTTP и укажите, что нужно:

отправь это в Caido replay и сделай скриншот:

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

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

Выбрать конкретную сессию

Сессии называются по строке запроса в боковой панели Caido, поэтому GET /, POST /login и так далее:

сделай скриншот сессии replay "POST /login"

Это превращается в caido_screenshot(session: "POST /login"). Каждый захват использует режим Side by Side.

Для надёжной автоматизации используйте ID сессии:

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

Если сессия находится в другой или свёрнутой коллекции, укажите обе:

сделай скриншот "01 admin create private conversation" из коллекции "OBS AI Assistant IDOR - Fresh Evidence"

Это превращается в caido_screenshot(collection: "OBS AI Assistant IDOR - Fresh Evidence", session: "01 admin create private conversation"). Инструмент раскрывает коллекцию перед выбором сессии и захватывает её в режиме Side by Side.

Внимание: caido_send_request автоматически называет сессии по строке запроса, поэтому несколько целей могут оказаться с именем GET /. Переименуйте сессию в Caido перед захватом, если нужно однозначно ссылаться на неё.

Сохранить в определённое место

сделай скриншот и сохрани в ~/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 и отклоняет все вызовы 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