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

FFmpeg debe estar instalado y accesible en su sistema PATH
Python 3.9 o superior
Paquetes de Python necesarios:
mcp httpx

Instalación

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
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

{
  "mcpServers": {
    "video-editor": {
      "command": "uv",
      "args": ["run", "video-editor"]
    }
  }
}

Desarrollo

Construcción y publicación

Dependencias de sincronización:
uv sync
Paquete de compilación:
uv build
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:

npx @modelcontextprotocol/inspector uv --directory /path/to/video_editor run video-editor

Ejemplo de uso

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

Recortar video.mp4 de 1:30 a 2:45
Convertir input.mp4 a formato WebM
"Acelerar el vídeo .mp4 al doble"
Fusionar video1.mp4 y video2.mp4
Extraer audio de un video.mp4
"Añadir subtítulos.srt al vídeo.mp4"

El servidor hará lo siguiente:

Analizar su solicitud
Generar el comando FFmpeg apropiado
Ejecútalo con seguimiento del progreso
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:

Bifurcar el repositorio
Crea tu rama de funciones
Realiza tus cambios
Enviar una solicitud de extracción

Video Editor MCP Server

Integrations