Communitygithub.com

bhubbard/ffmpeg-skill-rs

Fork nativo de alto rendimiento en Rust de ffmpeg-skill. Kit de herramientas determinista para manipulación de medios FFmpeg y servidor MCP (Model Context Protocol) para programadores pares IA y creadores.

¿Qué es ffmpeg-skill-rs?

ffmpeg-skill-rs es un puerto y fork nativo de alto rendimiento en Rust del proyecto ffmpeg-skill. Reemplaza scripts frágiles de shell/Python con un único binario nativo estático y enlazable que ofrece tipado estricto, latencia de invocación inferior al milisegundo y un servidor MCP (Model Context Protocol) JSON-RPC 2.0 integrado sobre stdio. Su utilidad principal radica en proporcionar una interfaz determinista y eficiente para que agentes de IA (como Claude Desktop, Cursor o Antigravity) realicen operaciones complejas de manipulación de medios: recorte, ajuste de relación de aspecto, detección de recuadros negros, normalización de sonido EBU R128, eliminación de silencios, concatenación con transiciones, generación de formas de onda y más. El proyecto soporta aceleración por hardware en Apple Silicon (VideoToolbox), Nvidia NVENC y VAAPI, y emite contratos de especificación JSON legibles por máquina (contract_version: "1.0") para garantizar una ejecución fiable por parte de agentes autónomos. Su diseño como binario único elimina dependencias de entornos Python o Node.js, simplificando drásticamente la integración en pipelines de CI/CD y configuraciones de escritorio.

Compatible con✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add bhubbard/ffmpeg-skill-rs

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

ffmpeg-skill-rs (fms)

ffmpeg-skill-rs es un puerto y fork nativo de alto rendimiento en Rust de kajisho5/ffmpeg-skill. Reemplaza scripts frágiles de shell/Python con un único binario nativo estático y enlazable que ofrece tipado estricto, latencia de invocación inferior al milisegundo y un servidor MCP (Model Context Protocol) JSON-RPC 2.0 integrado sobre stdio.

Aspectos destacados

  • Sin sobrecarga en tiempo de ejecución: Un único binario nativo compilado en Rust (ffmpeg-skill / alias fms). No requiere Python, Node.js ni entornos pip.
  • Servidor MCP integrado: Integración instantánea con Claude Desktop, Cursor, Antigravity, Open WebUI y otros agentes de IA (fms mcp).
  • Contrato determinista legible por máquina: Emite especificaciones JSON contract_version: "1.0" para una ejecución fiable de herramientas por parte de agentes de codificación autónomos.
  • Presets acelerados por hardware: Aprovecha automáticamente Apple Silicon VideoToolbox (h264_videotoolbox, hevc_videotoolbox, prores_videotoolbox), Nvidia NVENC y VAAPI.
  • Corte inteligente de saltos y EBU R128 en dos pasadas: Eliminación perfecta de silencios y normalización de sonoridad de audio de calidad broadcast.

Uso en CLI

# Inspección de capacidades y aceleración por hardware
fms doctor

# Sondeo profundo de medios con selectores de campo punteados
fms probe input.mp4 --compact
fms probe input.mp4 --field "duration"
fms probe input.mp4 --field "video[0].codec"

# Corte sin pérdida o con precisión de fotograma
fms cut input.mp4 --start 00:01:30 --duration 15.5
fms cut input.mp4 --start 10.0 --end 25.0 --accurate -o output.mp4

# Conformado de relación de aspecto (relleno, recorte, desenfoque)
fms fit input.mp4 -a 9:16 -m pad --fps 60

# Recorte exacto de rectángulo delimitador
fms crop input.mp4 -W 1080 -H 1080 -x 420 -y 0

# Detección de barras negras / letterbox
fms cropdetect movie.mp4 --limit 30 --json

# Presets de entrega para plataformas (YouTube, Reels, TikTok, ProRes, GIF)
fms export input.mov --preset reels
fms export input.mov --preset youtube4k
fms export clip.mp4 --preset gif --fps 15

# Concatenación con transiciones de fundido cruzado
fms join clip1.mp4 clip2.mp4 clip3.mp4 --transition dissolve --transition-duration 1.0

# Normalización de sonoridad EBU R128 en dos pasadas
fms loudness podcast.wav --preset podcast -o podcast_master.wav

# Eliminación de silencios (corte de saltos)
fms silence raw_take.mp4 --noise-db -28 --min-duration 0.4 --remove

# Manipulación de velocidad con preservación de tono (atempo)
fms speedramp video.mp4 --speed 1.5

# Renderizado visual de forma de onda y espectrograma
fms waveform audio.mp3 --mode waveform -W 1920 -H 400 -o waveform.png

# Detección de cortes de escena y extracción de miniaturas
fms scenes video.mp4 --threshold 0.35 -d ./thumbnails

# Validador de cumplimiento de especificaciones previas a la entrega
fms check final_cut.mp4 --platform reels --json

# Emitir contrato JSON legible por máquina
fms contract --json

Configuración del Model Context Protocol (MCP)

Añade ffmpeg-skill a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json, gemini o cursor):

{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "ffmpeg-skill",
      "args": ["mcp"]
    }
  }
}

Skills relacionados