MCP Ffmpeg Helper

What is Mcp Ffmpeg Helper?

Mcp Ffmpeg Helper is a lightweight Model Context Protocol (MCP) server that exposes FFmpeg’s video processing capabilities to AI assistants. It provides tools for common FFmpeg operations such as format conversion, audio extraction, trimming, watermarking, and frame extraction. It is intended for users who want to control FFmpeg through natural language commands in MCP‑compatible applications like Windsurf.

How to use Mcp Ffmpeg Helper?

Install Node.js (v14+) and FFmpeg (must be in system PATH). Clone the repository, run npm install and npm run build, then add the server configuration to the MCP config file (e.g., mcp_config.json for Windsurf). Alternatively, use the npm package @sworddut/mcp-ffmpeg-helper with npx without cloning. Once configured, users issue natural language commands such as “请帮我查看…视频信息” to invoke tools.

Key features of Mcp Ffmpeg Helper

• Get detailed video file information (format, codec, resolution, framerate).
• Convert videos between formats with optional encoding options.
• Extract audio tracks from video files.
• Create videos from image sequences.
• Trim videos and audio to specified time ranges.
• Add image watermarks with position and opacity control.
• Extract video frames as image sequences (PNG, JPG).

Use cases of Mcp Ffmpeg Helper

• Automate batch video format conversion via an AI chatbot.
• Extract a segment from a long video or audio file for quick editing.
• Create a time‑lapse video from a series of still images.
• Add a logo watermark to a video before publishing.
• Quickly inspect video metadata without running FFmpeg manually.