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
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
- macOS:
brew install ffmpeg - Ubuntu/Debian:
sudo apt-get install ffmpeg - Windows: Descárgalo desde sitio web oficial de FFmpeg
- macOS:
-
ImageMagick: Requerido para operaciones de procesamiento de imágenes
- macOS:
brew install imagemagick - Ubuntu/Debian:
sudo apt-get install imagemagick - Windows: Descárgalo desde sitio web oficial de ImageMagick
- macOS:
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 entradaoptions(string[]): Matriz de opciones de comando de FFmpegoutputPath(string, opcional): Ruta absoluta para el archivo de salidaoutputFilename(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 entradaoutputFormat(string): Formato de salida deseado (p. ej., mp4, mkv, avi)outputPath(string, opcional): Ruta de salida personalizadaoutputFilename(string, opcional): Nombre de archivo de salida personalizado
-
compress-video
- Comprime archivo de video
- Entradas:
inputPath(string): Ruta absoluta al archivo de video de entradaquality(number, opcional): Calidad de compresión (1-51, menor es mejor calidad)outputPath(string, opcional): Ruta de salida personalizadaoutputFilename(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 entradastartTime(string): Hora de inicio en formato HH:MM:SSduration(string): Duración en formato HH:MM:SSoutputPath(string, opcional): Ruta de salida personalizadaoutputFilename(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 entradaquality(number, opcional): Calidad de compresión (1-100)outputPath(string, opcional): Ruta de salida personalizadaoutputFilename(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 entradaoutputFormat(string): Formato de salida deseado (p. ej., jpg, png, webp, gif)outputPath(string, opcional): Ruta de salida personalizadaoutputFilename(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 entradawidth(number, opcional): Ancho objetivo en píxelesheight(number, opcional): Alto objetivo en píxelesmaintainAspectRatio(boolean, opcional): Si se debe mantener la relación de aspectooutputPath(string, opcional): Ruta de salida personalizadaoutputFilename(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 entradadegrees(number): Ángulo de rotación en gradosoutputPath(string, opcional): Ruta de salida personalizadaoutputFilename(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 entradawatermarkPath(string): Ruta absoluta al archivo de imagen de la marca de aguaposition(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 personalizadaoutputFilename(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 entradaeffect(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 personalizadaoutputFilename(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.