로컬 Snagit MCP 서버

이미 설치된 TechSmith Snagit 사본으로 GitHub Copilot이 데모 비디오를 녹화할 수 있게 해주는 로컬 MCP 서버입니다. Copilot이 터미널 워크스루, 배포, 또는 배포된 앱에 대한 Playwright 세션 등 다른 모든 작업을 주도하는 것처럼 녹화도 주도하며, MP4 파일을 돌려받습니다.

Snagit의 자체 SNAGIT.VideoCapture COM 자동화 인터페이스를 통해 Snagit과 통신하므로, 핫키 시뮬레이션, UI 스크립팅, 타사 화면 녹화기가 필요 없습니다.

요구 사항

• Windows

• Snagit 2023 이상, 설치 후 최소 한 번은 실행된 상태 (Snagit 2025, 25.4.0.8498에서 검증됨)

• Python 3.10+

Related MCP server: snip-mcp

설정

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .
.\.venv\Scripts\python.exe -m snagit_mcp --selftest

--selftest는 "ready": true를 보고해야 합니다. 그렇지 않다면 문제 해결을 참조하세요.

이 저장소에는 .vscode/mcp.json이 포함되어 있어, 폴더를 열면 VS Code가 서버 시작을 제안합니다. 다른 워크스페이스에서 사용하려면 ${workspaceFolder} 대신 절대 경로를 사용하여 동일한 블록을 사용자 수준 mcp.json에 추가하세요.

녹화물은 SNAGIT_MCP_OUTPUT_DIR에 저장됩니다 (기본값은 워크스페이스 recordings/ 폴더, 설정하지 않으면 %USERPROFILE%\Videos\Snagit MCP).

도구

또한 Copilot에게 전체 샷 목록 우선 절차를 제공하는 record_app_demo 프롬프트(VS Code의 슬래시 명령)도 있습니다.

배포된 앱 데모 녹화

Snagit은 실제 픽셀을 녹화하므로 브라우저가 보여야 합니다 — headless가 아닌 headed 모드로 Playwright를 실행하세요. Playwright MCP 서버와 결합하면 세션은 다음과 같습니다:

1. Playwright MCP가 App Service URL을 headed 브라우저에서 열고 로그인합니다.

2. title_contains: "Edge"(또는 Chrome)와 함께 list_windows를 사용하면 브라우저 창 핸들이 반환됩니다.

3. target: "window"와 해당 핸들로 start_recording을 호출합니다. Snagit의 카운트다운 후 반환되므로 다음 동작이 이미 카메라에 잡힙니다.

4. Playwright가 시나리오를 클릭하며 진행하고, 단계 사이에 wait를 사용하면 따라가기 쉽습니다.

5. stop_recording이 MP4 경로를 반환합니다.

VS Code, 터미널, Azure 포털, 브라우저를 오가는 저장소 워크스루의 경우 단일 창 대신 list_displays의 display_index와 함께 target: "fullscreen"을 사용하세요.

평범한 언어로 요청하세요. 예:

배포 흐름 데모를 녹화해 줘: README의 사전 요구 사항을 보여주고, 배포 스크립트를 실행한 다음 App Service URL을 열고 레코드 생성 과정을 보여줘. 디스플레이 0을 사용해.

Snagit을 구동하는 방식

이러한 동작은 실험을 통해 확인되었으며 src/snagit_mcp/recorder.py의 타이밍은 이에 의존합니다:

• 순서는 Capture()로 준비, 3초 대기, Start(), 그다음 Stop()입니다. Capture() 직후 Start()를 너무 빨리 호출하면 2KB의 빈 MP4가 생성됩니다.

• Snagit은 Start() 후 약 3.4초 카운트다운을 재생합니다. start_recording이 이를 흡수하고 실제 녹화가 시작된 후에만 반환합니다.

• Snagit의 녹화 도구 모음은 계속 보여야 합니다. HideRecordingUI = True로 설정하면 녹화가 조용히 몇 초로 잘립니다. 도구 모음은 캡처 영역 밖에 있으므로 비디오에 나타나지 않습니다.

• 마이크와 시스템 오디오는 이 Snagit 빌드에서 COM으로 설정할 수 없습니다 — 해당 setter는 예외를 던지며, 실패한 쓰기는 캡처 엔진을 멈추게 할 수 있습니다. 따라서 오디오는 Snagit 자체 캡처 설정에 구성된 대로 따릅니다. 내레이션이 필요하면 녹화 전에 거기서 설정하세요.

• RecordingDuration, FrameCount, AverageFrameRate는 Stop() 이후에만 의미가 있습니다. 녹화 중에는 recording_status가 서버 자체의 벽시계 시간을 보고합니다.

• 출력은 파일로 직접 전달됩니다. 촬영 사이에 Snagit Editor가 팝업되지 않습니다.

Snagit 업그레이드 후 검증

.\.venv\Scripts\python.exe tests\smoke_recording.py

MCP 도구를 통해 실제 5초 클립을 녹화하고 결과 MP4의 길이를 확인합니다. 향후 Snagit 릴리스가 카운트다운이나 준비 동작을 변경하면 이 검증이 이를 잡아냅니다.

문제 해결

카메라에 잡히는 내용에 대한 참고 사항

화면 녹화는 터미널 출력, 토큰, 포털 세션, 알림을 포함하여 화면에 있는 모든 것을 캡처합니다. 녹화 전에 민감한 내용을 닫거나 지우고, 공유 전에 MP4를 검토하세요.