MCP Ffmpeg Tools

@gamhoi

Basic information

About MCP Ffmpeg Tools

An open-source Python MCP (Model-Command Protocol) server designed to enable Large Language Models (LLMs) to execute FFmpeg commands, receive execution results, and validate commands against FFmpeg source code.

#mcp-ffmpeg #media-processing #llm-tools

MCP Ffmpeg Tools config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-ffmpeg-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO/mcp-ffmpeg-tools",
        "run",
        "ffmpeg-tools"
      ]
    }
  }
}

MCP Ffmpeg Tools tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-ffmpeg-tools?

mcp-ffmpeg-tools is an open-source Python MCP (Model-Command Protocol) server that enables Large Language Models (LLMs) to execute FFmpeg commands, receive execution results, and validate commands against FFmpeg source code for accurate media processing.

How to use mcp-ffmpeg-tools?

Install FFmpeg, then clone the repository, create a virtual environment with uv venv, and install with uv pip install -e .. For Claude Desktop, add the provided JSON configuration specifying the uv command and path. Alternatively, run via Docker with docker pull gamhoi/mcp-ffmpeg-tools:latest and configure the HTTP endpoint.

Key features of mcp-ffmpeg-tools

Execute FFmpeg commands through an MCP interface
Receive detailed execution results and error messages
Validate commands using FFmpeg source code
Cross-platform support (Windows, macOS, Linux)
Environment management using uv
Docker support with HTTP mode and file mounting

Use cases of mcp-ffmpeg-tools

Extract all media streams from a video file
Overlay two videos with scaling and positioning
Inspect media properties using ffprobe
Capture screenshots to verify video layout and quality
Automate media conversion tasks via LLM assistance

Frequently asked questions

What is mcp-ffmpeg-tools for?

It allows LLMs to run FFmpeg commands, get results, and validate commands against FFmpeg source code, enabling automated media processing.

What are the prerequisites?

FFmpeg must be installed on your system and accessible in the PATH. Instructions for Windows, macOS, and Linux are provided.

How do I install mcp-ffmpeg-tools?

Clone the repository, then run `uv venv` and `uv pip install -e .` in the project directory. The installer verifies FFmpeg and downloads the corresponding source code.

Can I use mcp-ffmpeg-tools with Docker?

Yes. Pull the image from Docker Hub (`gamhoi/mcp-ffmpeg-tools:latest`) and run it on port 8000. Mount host directories with `-v` to access local files.

How do I configure it with Claude Desktop?

Add a JSON entry to your Claude Desktop settings with `command: "uv"`, arguments pointing to the project directory, and `"run", "ffmpeg-tools"`. For Docker, use `type: "streamableHttp"` and the server URL.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

ICSS

chokcoco

不止于 CSS

20.7K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea