MCP Media Processing Server

Un servidor para procesamiento de medios, que ofrece potentes manipulaciones de video e imagen utilizando FFmpeg y ImageMagick.

Documentación

MCP Media Processing Server

smithery badge

Un servidor Node.js que implementa el Model Context Protocol (MCP) para operaciones de procesamiento de medios, proporcionando potentes capacidades de manipulación de video e imágenes.

Características

  • Procesamiento y conversión de video
  • Procesamiento y manipulación de imágenes
  • Compresión de medios
  • Recorte y edición de video
  • Efectos de imagen y marcas de agua

Requisitos previos

Antes de usar este servidor, asegúrate de tener las siguientes dependencias instaladas en tu sistema:

  • FFmpeg: Requerido para operaciones de procesamiento de video

  • ImageMagick: Requerido para operaciones de procesamiento de imágenes

Cómo usar

Añade esto a tu claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "mediaProcessor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-media-processor@latest"
      ]
    }
  }
}

API

Herramientas

Operaciones de Video

  • execute-ffmpeg

    • Ejecuta cualquier comando de FFmpeg con opciones personalizadas
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de video de entrada
      • options (string[]): Matriz de opciones de comando de FFmpeg
      • outputPath (string, opcional): Ruta absoluta para el archivo de salida
      • outputFilename (string, opcional): Nombre del archivo de salida
  • convert-video

    • Convierte video a un formato diferente
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de video de entrada
      • outputFormat (string): Formato de salida deseado (p. ej., mp4, mkv, avi)
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • compress-video

    • Comprime archivo de video
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de video de entrada
      • quality (number, opcional): Calidad de compresión (1-51, menor es mejor calidad)
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • trim-video

    • Recorta video a la duración especificada
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de video de entrada
      • startTime (string): Hora de inicio en formato HH:MM:SS
      • duration (string): Duración en formato HH:MM:SS
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado

Operaciones de Imagen

  • compress-image

    • Comprime imagen PNG usando ImageMagick
    • Entradas:
      • inputPath (string): Ruta absoluta a la imagen PNG de entrada
      • quality (number, opcional): Calidad de compresión (1-100)
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • convert-image

    • Convierte imagen a un formato diferente
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de imagen de entrada
      • outputFormat (string): Formato de salida deseado (p. ej., jpg, png, webp, gif)
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • resize-image

    • Redimensiona imagen a las dimensiones especificadas
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de imagen de entrada
      • width (number, opcional): Ancho objetivo en píxeles
      • height (number, opcional): Alto objetivo en píxeles
      • maintainAspectRatio (boolean, opcional): Si se debe mantener la relación de aspecto
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • rotate-image

    • Rota imagen por los grados especificados
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de imagen de entrada
      • degrees (number): Ángulo de rotación en grados
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • add-watermark

    • Añade marca de agua a la imagen
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de imagen de entrada
      • watermarkPath (string): Ruta absoluta al archivo de imagen de la marca de agua
      • position (string, opcional): Posición de la marca de agua (predeterminado: "southeast")
      • opacity (number, opcional): Opacidad de la marca de agua (0-100)
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado
  • apply-effect

    • Aplica efecto visual a la imagen
    • Entradas:
      • inputPath (string): Ruta absoluta al archivo de imagen de entrada
      • effect (string): Efecto a aplicar (blur, sharpen, edge, emboss, grayscale, sepia, negate)
      • intensity (number, opcional): Intensidad del efecto (0-100)
      • outputPath (string, opcional): Ruta de salida personalizada
      • outputFilename (string, opcional): Nombre de archivo de salida personalizado

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.