Servidor local de Snagit MCP

Un servidor MCP local que permite a GitHub Copilot grabar vídeos de demostración con la copia de TechSmith Snagit ya instalada en tu máquina. Copilot controla la grabación mientras controla todo lo demás — un recorrido por la terminal, un despliegue o una sesión de Playwright contra tu aplicación desplegada — y recibe un MP4.

Se comunica con Snagit a través de la interfaz de automatización COM SNAGIT.VideoCapture de Snagit, por lo que no hay simulaciones de teclas de acceso rápido, ni scripts de interfaz de usuario, ni grabadores de pantalla de terceros.

Requisitos

• Windows

• Snagit 2023 o más reciente, instalado y lanzado al menos una vez (verificado con Snagit 2025, 25.4.0.8498)

• Python 3.10+

Related MCP server: autodemo

Configuración

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

--selftest debería informar "ready": true. Si no lo hace, consulta Solución de problemas.

El repositorio incluye .vscode/mcp.json, por lo que VS Code ofrece iniciar el servidor en cuanto abras la carpeta. Para usarlo desde cualquier espacio de trabajo, añade el mismo bloque a tu mcp.json a nivel de usuario con rutas absolutas en lugar de ${workspaceFolder}.

Las grabaciones se guardan en SNAGIT_MCP_OUTPUT_DIR (la carpeta recordings/ del espacio de trabajo por defecto, o %USERPROFILE%\Videos\Snagit MCP si no se establece).

Herramientas

También hay un prompt record_app_demo (un comando de barra en VS Code) que le da a Copilot el procedimiento completo de lista de tomas primero.

Grabación de una demostración de una aplicación desplegada

Snagit graba píxeles reales, por lo que el navegador debe ser visible: ejecuta Playwright con interfaz gráfica, no sin cabeza. Combinado con el servidor MCP de Playwright, una sesión se ve así:

1. Playwright MCP abre la URL de tu App Service en un navegador con interfaz gráfica e inicia sesión.

2. list_windows con title_contains: "Edge" (o Chrome) devuelve el identificador de la ventana del navegador.

3. start_recording con target: "window" y ese identificador. Devuelve después de la cuenta atrás de Snagit, por lo que la siguiente acción ya está en cámara.

4. Playwright hace clic a través del escenario; wait entre pasos lo mantiene comprensible.

5. stop_recording devuelve la ruta del MP4.

Para un recorrido por el repositorio que se mueve entre VS Code, una terminal, el portal de Azure y el navegador, usa target: "fullscreen" con el display_index de list_displays en lugar de una sola ventana.

Pídelo en lenguaje natural, por ejemplo:

Graba una demostración del flujo de despliegue: muestra los requisitos previos en el README, ejecuta el script de despliegue, luego abre la URL de App Service y recorre la creación de un registro. Usa la pantalla 0.

Cómo controla Snagit

Estos comportamientos se establecieron mediante experimentos y los tiempos en src/snagit_mcp/recorder.py dependen de ellos:

• La secuencia es Capture() para armar, una espera de 3 s, Start() y luego Stop(). Llamar a Start() demasiado pronto después de Capture() produce un MP4 vacío de 2 KB.

• Snagit reproduce una cuenta atrás de ~3,4 s después de Start(). start_recording la absorbe y solo devuelve una vez que la grabación real ha comenzado.

• La barra de herramientas de grabación de Snagit debe permanecer visible. Establecer HideRecordingUI = True trunca silenciosamente las grabaciones a un par de segundos. La barra de herramientas está fuera de la región capturada, por lo que no aparece en el vídeo.

• El micrófono y el audio del sistema no se pueden configurar a través de COM en esta versión de Snagit: esos setters lanzan una excepción, y una escritura fallida puede bloquear el motor de captura. Por lo tanto, el audio sigue lo que esté configurado en los ajustes de captura de Snagit. Configúralo allí antes de grabar si quieres narración.

• RecordingDuration, FrameCount y AverageFrameRate solo tienen sentido después de Stop(); durante una grabación, recording_status informa del reloj de pared del propio servidor.

• La salida va directamente a un archivo. El editor de Snagit no aparece entre tomas.

Verificación después de una actualización de Snagit

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

Graba un clip real de 5 segundos a través de las herramientas MCP y comprueba la duración del MP4 resultante. Si una futura versión de Snagit cambia la cuenta atrás o el comportamiento de armado, esto es lo que lo detectará.

Solución de problemas

Una nota sobre lo que aparece en cámara

La grabación de pantalla captura todo lo que está en pantalla, incluida la salida de la terminal, tokens, sesiones de portal y notificaciones. Cierra o borra cualquier cosa sensible antes de grabar y revisa el MP4 antes de compartirlo.