site-motion-capture

이 MCP 서버는 임대한 Vast.ai GPU VM에서 라이브 웹사이트 모션을 캡처합니다. 해당 VM의 기존 Playwright 레코더를 사용하고 WebM 비디오와 jank 리포트를 로컬 머신으로 복사합니다.

design-inspiration을 사용하여 후보 사이트를 찾으세요. 사이트가 선택되고 라이브 동작을 검사해야 할 때 이 서버를 사용하세요.

도구

• capture_site_motion은 페이지 로드, 스크롤, 선택적 호버 또는 클릭 동작을 기록합니다. 데스크톱 캡처는 기본적으로 1920×1080입니다. 로컬 및 원격 아티팩트 경로를 반환합니다. MCP는 Playwright의 WebM 인코더를 8Mbps 목표로 유지하여 텍스트와 미세한 UI 세부 사항을 읽을 수 있게 합니다. 기본적으로 필수적이지 않은 쿠키 동의를 거부하고 그 동작을 jank 리포트에 기록합니다.

• check_capture_gpu는 nvidia-smi와 Chromium WebGL 렌더러를 모두 확인합니다.

Related MCP server: screenwright

동의 및 인터랙션 정책

캡처는 기본적으로 consent_mode: "reject"를 사용합니다. 공개 옵션은 다음과 같습니다.

• reject는 필수적이지 않은 쿠키를 거부하고 그 동작을 기록합니다.

• accept는 consent_accept_approved: true가 명시적으로 제공된 경우에만 모든 쿠키를 수락합니다. 그 외에는 안전하게 실패(fail closed)합니다.

• none은 페이지를 건드리지 않으며 동의 처리를 시도하지 않습니다.

• granular은 설정, 선택 쿠키, 저장 선택자를 순서대로 적용합니다.

레코더는 기록되지 않는 사전 점검(preflight) 컨텍스트를 사용한 다음, 그 저장 상태를 기록 컨텍스트로 가져옵니다. 하위 프레임을 포함해 두 컨텍스트를 모두 확인합니다. reject, accept, granular의 경우, 필요한 작업 후 동의 표면(consent surface)이 사라졌을 때만 결과가 verified입니다. 그러면 dismissed가 true입니다. 안전한 컨트롤을 찾지 못하면 결과는 no-safe-action입니다. 표면이 남아 있거나 맹점으로 검증이 불가능하면 결과는 verified가 아닙니다. none 모드에서는 대화상자가 없으면 verified: true, dismissed: false, 결과는 no-consent-surface입니다. 대화상자가 있으면 verified: false, dismissed: false, 결과는 consent-surface-present입니다. 페이지가 동의 또는 스크롤 검사를 차단하면 레코더는 해당 검사에 한계를 두고 consent-check-timeout을 맹점 항목과 함께 보고합니다. 비디오는 여전히 게시할 수 있지만 동의가 검증된 것으로 취급해서는 안 됩니다. 리포트에는 모드, 작업, 선택자, 단계, 프레임, 이유, 시도 횟수, 예산, 클릭 수가 유지됩니다.

특이한 컨트롤의 경우 consent_selector를 전달하세요. 이는 대상 컨트롤에 대한 명시적이고 안정적인 CSS 선택자여야 합니다. hover_selector와 click_selector에도 같은 규칙이 적용됩니다. 선택자는 iframe 경계를 넘지 않습니다. 자동 감지는 shadow-DOM 컨트롤과 닫힌 shadow root 뒤에 숨은 컨트롤을 놓칠 수 있습니다.

consent_wait_ms는 레코더가 대화상자를 기다리는 시간을 설정합니다. consent_preflight: false로 설정하면 기록되지 않는 사전 점검을 건너뜁니다. 현지화 지침은 영어로 작성해야 하며 각 현지화된 컨트롤에 대한 명시적 선택자를 포함해야 합니다. 번역된 표시 텍스트만으로 판단하지 마세요.

각 캡처를 8초 인터랙션 예산 안에 유지하세요. 기본 발견 패스는 최대 6회 클릭을 사용합니다. 해당 패스 외부의 필수 인터랙션에는 명시적 선택자를 추가하세요. 자동 발견은 최선을 다하지만 모든 인터랙션이 캡처되었음을 증명하지는 않습니다.

로컬 name은 복사된 .webm 및 .jank.json 파일의 안정적인 파일 스템(stem)입니다. 원격 실행 ID가 아닙니다. 실행을 비교할 때는 로컬 이름을 안정적으로 유지하세요. 원격 로그와 정리에는 원격 실행 ID를 사용하세요. 가능하면 overwrite: false를 사용하여 기존 로컬 캡처를 보존하세요. 정리는 아티팩트별로 removed, missing, skipped, failed 중 하나의 상태를 보고합니다. 정리 실패가 캡처 실패를 의미하지는 않습니다.

런타임

서버에는 npm 의존성이 없습니다. 런처는 Vast API 키와 Vast CLI 환경을 위해 ~/.zsh_secrets를 소싱합니다. API 키는 MCP 구성에 나타나지 않습니다.

런처는 Vast CLI로 인스턴스 48790763의 SSH 엔드포인트를 확인합니다. 캡처 VM이 변경되면 VAST_INSTANCE_ID 또는 SITE_MOTION_SSH_URL로 재정의하세요.

원격 레코더는 /workspace/site-motion-capture에 있어야 하며 capture.mjs와 check-gpu-renderer.mjs를 제공해야 합니다.