Procesador de vídeo MCP FFmpeg

Un servidor Node.js que utiliza FFmpeg para manipular archivos de vídeo. Este servidor proporciona API para:

Cambiar el tamaño de los vídeos a diferentes resoluciones (360p, 480p, 720p, 1080p)
Extrae audio de vídeos en varios formatos (MP3, AAC, WAV, OGG)

Prerrequisitos

Antes de ejecutar esta aplicación, necesita tener instalado lo siguiente:

Node.js (v14 o superior)
FFmpeg : esto es necesario para el procesamiento de video

Instalación de FFmpeg

En macOS:

brew install ffmpeg

En Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

En Windows:

Descarga FFmpeg desde el sitio web oficial
Extraiga los archivos a una carpeta (por ejemplo, C:\ffmpeg )
Agregue la carpeta bin a su variable de entorno PATH

Instalación

Clonar este repositorio:

git clone https://github.com/bitscorp-mcp/mcp-ffmpeg.git
cd mcp-ffmpeg

Instalar dependencias:

npm install

Instalación mediante herrería

Para instalar mcp-ffmpeg para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

Ejecución del servidor

Inicie el servidor con:

npm start

Para el desarrollo con reinicio automático al cambiar archivos:

npm run dev

Instalación mediante herrería

Para instalar mcp-ffmpeg para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

Para instalar mcp-ffmpeg para Cursor, vaya a Configuración -> Configuración del cursor -> Características -> Servidores MCP -> + Agregar

Seleccione Tipo: comando y pegue lo siguiente, usando su clave API de Ajustar

npx -y @smithery/cli@latest run @bitscorp/mcp-ffmpeg

Uso con Claude Desktop

Este servidor MCP FFmpeg se puede integrar con Claude Desktop para procesar videos a través de solicitudes de lenguaje natural.

Ejecutando con npx

Puedes ejecutar el servidor directamente con npx:

npx /path/to/mcp-ffmpeg

O si has publicado el paquete en npm:

npx mcp-ffmpeg

Configuración de Claude Desktop

Para agregar este servidor a Claude Desktop, actualice su archivo de configuración de Claude Desktop:

Localice el archivo de configuración de Claude Desktop:
- macOS: ~/.config/claude-desktop/config.json o ~/Library/Application Support/Claude Desktop/config.json
- Ventanas: %APPDATA%\Claude Desktop\config.json
- Linux: ~/.config/claude-desktop/config.json
Agregue el servidor MCP FFmpeg a la sección mcpServers :

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "--yes",
                "/absolute/path/to/mcp-ffmpeg"
            ]
        }
    }
}

Si ha publicado el paquete en npm:

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

Reinicie Claude Desktop para que los cambios surtan efecto.

Ejemplos de indicaciones para Claude

Una vez configurado, puedes utilizar indicaciones como:

Using the ffmpeg MCP server, please resize the video at /path/to/video.mp4 to 720p resolution.

Notas

Los videos cargados se almacenan temporalmente en el directorio uploads
Los vídeos y archivos de audio procesados se almacenan en el directorio output
El servidor tiene un límite de tamaño de archivo de 500 MB para cargas.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

MCP FFmpeg Video Processor

Integrations