caido-screenshot-mcp

Caido Replay 요청/응답 쌍의 형식화된 스크린샷을 캡처하는 MCP 서버로, Screenshot Mode 플러그인을 구동합니다.

Caido에는 스크린샷 API가 없습니다. Screenshot Mode는 브라우저에서 DOM을 PNG로 렌더링하는 프런트엔드 전용 플러그인입니다. 이 서버는 Chrome DevTools Protocol을 통해 접근하며, 플러그인의 내보내기 버튼을 클릭하고, Electron이 저장 대화상자를 열기 전에 이미지를 가로챕니다. 출력은 플러그인의 실제 출력이며, 그대로 디스크에 기록됩니다.

요구 사항

• Node >= 22 (내장 WebSocket 사용; npm 의존성 없음)

• Caido 데스크톱

• Caido에 Screenshot Mode 플러그인 설치

• --remote-debugging-port로 시작된 Caido (아래 참조)

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를 시작하면 포트가 닫혀 있어 모든 호출이 실패합니다.

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 서버와 함께 사용하세요 — 이 서버는 결과를 캡처합니다.

Caido replay에서 https://httpbin.org/get에 GET을 보내고 스크린샷해 주세요

에이전트가 요청을 보내고, 반환된 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 등이 있습니다:

"POST /login" replay 세션을 스택으로 스크린샷해 주세요

그러면 caido_screenshot(session: "POST /login")이 됩니다. 모든 캡처는 Side by Side를 사용합니다.

안정적인 자동화를 위해 세션 ID를 사용하세요:

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

세션이 다른 컬렉션이나 접힌 컬렉션 안에 있으면 둘 다 지정하세요:

"OBS AI Assistant IDOR - Fresh Evidence" 컬렉션에서 "01 admin create private conversation"을 스크린샷해 주세요

그러면 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-to-image 렌더링은 때때로 줄을 생략하여 줄 번호에 눈에 띄는 공백이 생깁니다. 이 이미지는 정확한 증거가 아닌 참고용으로 취급하세요 — 정밀도가 중요할 때는 Caido의 자체 요청 내보내기를 사용하세요.

• 레이아웃은 Side by Side로 고정됩니다. 서버는 의도적으로 레이아웃이나 배열 옵션을 노출하지 않으므로 모든 증거 스크린샷이 동일한 보고서 준비 형식을 갖습니다.

• 스크린샷은 편집되지 않습니다. 화면에 표시된 모든 것 — Authorization, Cookie, Set-Cookie — 이 그대로 캡처됩니다. 공유 전에 검토하세요.

• 요청 전용 Replay 세션은 기본적으로 거부됩니다. 선택한 세션에 응답이 없으면 Screenshot Mode가 이전 미리보기를 유지할 수 있습니다. 요청 전용 스크린샷이 의도된 경우에만 --allow-no-response를 전달하세요.

문제 해결

라이선스

MIT