Servidor MCP del editor de vídeo

Un potente servidor MCP de edición de video que aprovecha FFmpeg para realizar operaciones de edición de video a través de comandos de lenguaje natural.

Componentes

Herramientas

El servidor implementa una herramienta principal:

• execute_ffmpeg : ejecuta comandos FFmpeg con seguimiento del progreso

  • Toma una cadena de comando como entrada

  • Valida y ejecuta operaciones FFmpeg

  • Informa sobre el progreso en tiempo real durante el procesamiento.

  • Maneja errores y proporciona retroalimentación detallada

  • Admite todas las operaciones FFmpeg, incluidas:

    • Recorte/corte

    • Fusionar vídeos

    • Conversión de formatos

    • Ajuste de la velocidad

    • Agregar pistas de audio

    • Extrayendo audio

    • Añadiendo subtítulos

    • Filtros básicos (brillo, contraste, etc.)

Configuración

Prerrequisitos

1. FFmpeg debe estar instalado y accesible en su sistema PATH

2. Python 3.9 o superior

3. Paquetes de Python necesarios:

   mcp httpx

Instalación

1. Instale FFmpeg si aún no está instalado:

   # On macOS with Homebrew brew install ffmpeg # On Windows with Chocolatey choco install ffmpeg # On Ubuntu/Debian sudo apt install ffmpeg

2. Instalar el paquete del editor de vídeo:

   uv add video-editor

Integración de escritorio de Claude

Configure en su archivo de configuración de Claude Desktop:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Desarrollo

Construcción y publicación

1. Dependencias de sincronización:

   uv sync

2. Paquete de compilación:

   uv build

3. Publicar en PyPI:

   uv publish

Nota: Establezca las credenciales de PyPI mediante:

• Token: --token o UV_PUBLISH_TOKEN

• O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Para obtener la mejor experiencia de depuración, utilice el Inspector MCP:

Ejemplo de uso

Una vez conectado a Claude Desktop, podrá realizar solicitudes en lenguaje natural como:

1. Recortar video.mp4 de 1:30 a 2:45

2. Convertir input.mp4 a formato WebM

3. "Acelerar el vídeo .mp4 al doble"

4. Fusionar video1.mp4 y video2.mp4

5. Extraer audio de un video.mp4

6. "Añadir subtítulos.srt al vídeo.mp4"

El servidor hará lo siguiente:

1. Analizar su solicitud

2. Generar el comando FFmpeg apropiado

3. Ejecútalo con seguimiento del progreso

4. Proporcionar retroalimentación al finalizar

Manejo de errores

El servidor incluye un manejo robusto de errores para:

• Archivos de entrada no válidos

• Comandos FFmpeg malformados

• Errores de ejecución en tiempo de ejecución

• Problemas de seguimiento del progreso

Todos los errores se informan al cliente con mensajes detallados para su depuración.

Consideraciones de seguridad

• Sólo procesa archivos en directorios explícitamente permitidos

• Valida los comandos FFmpeg antes de su ejecución

• Desinfecta todos los parámetros de entrada

• Informa mensajes de error detallados sobre problemas relacionados con la seguridad.

Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

1. Bifurcar el repositorio

2. Crea tu rama de funciones

3. Realiza tus cambios

4. Enviar una solicitud de extracción