dsh-plugin-media-studio — edición de video con ffmpeg para DeepSeek Harness

Plugin MCP local para probar, convertir, recortar, hacer clips verticales, miniaturas y quemar subtítulos con el ffmpeg de tu máquina. Rutas permitidas, nada de sobrescribir originales, auditoría y modo read-only.

English · Cómo funciona · MIT

Herramientas (7)

Related MCP server: mcp-ffmpeg

Requisitos

• ffmpeg y ffprobe en el PATH (o ffmpegPath/ffprobePath en la config). En Windows: winget install Gyan.FFmpeg (incluye ambos).

• Node ≥ 20 (lo aporta el harness).

Configuración

Archivo: <DSH_HOME>\media-studio\config.json (el postinstall lo crea con allowedPaths = tu perfil).

{
  "allowedPaths": ["C:\\Users\\tu-usuario"],
  "ffmpegPath": "",
  "ffprobePath": "",
  "note": "ffmpegPath/ffprobePath vacíos usan PATH."
}

• allowedPaths: carpetas desde las que se puede leer y escribir. Las salidas por defecto van a <DSH_HOME>\cache\media-studio.

• Variables de entorno opcionales: DSH_FFMPEG_PATH, DSH_FFPROBE_PATH.

Instalación

Desde DSH → Settings → Plugins instala github:thegabopacheco-sudo/dsh-plugin-media-studio y permite el script de instalación.

CLI:

dsh plugin --profile <perfil> add github:thegabopacheco-sudo/dsh-plugin-media-studio

El postinstall copia el runtime a <DSH_HOME>\plugins\media-studio y crea la config base.

Ejemplos de pedidos

• «Analiza este video y dime duración y resolución.»

• «Recorta del minuto 1:20 al 1:45.»

• «Hazme un vertical 9:16 para Shorts.»

• «Sácame una miniatura en el segundo 5.»

• «Quémale estos subtítulos y guárdalo como mp4.»

• «Pásalo a gif de 480 px.»

Seguridad

• Rutas permitidas (allowedPaths): no lee ni escribe fuera de ellas.

• Nunca sobrescribe la entrada; si el destino existe, crea un nombre único.

• Modo read-only (DSH_MEDIA_MODE=read-only): solo status/probe.

• Límite de 6 operaciones pesadas por minuto.

• Auditoría en <DSH_HOME>\cache\media-studio\audit.jsonl.

• Sin comandos arbitrarios: los args de ffmpeg se construyen desde parámetros validados (enums, números y tiempos).

Variables de entorno

Solución de problemas

• “no se pudo ejecutar ffmpeg”: instala ffmpeg, verifica ffmpeg -version o define DSH_FFMPEG_PATH.

• “ruta no permitida”: agrega la carpeta a allowedPaths.

• Subtítulos quemados fallan: usa .srt/.vtt UTF-8; el filtro escapa rutas de Windows automáticamente.

• Permiso de scripts en la instalación: aprueba el postinstall; si el cartel se repite, allowBuilds: true en pnpm-workspace.yaml.

Desarrollo

npm install
npm run build:bundle
cd test; npm install; node connect-test.mjs   # genera un video con ffmpeg

Licencia

MIT © thegabopacheco-sudo