Advertise
MCP.so
Sign In

MCP Ffmpeg Tools

@gamhoi

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

gamhoi

Submitted by

JINKAI CHEN

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

1

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.

2

What are the prerequisites?

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

3

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.

4

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.

5

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

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

der die das – German noun genders (Lingviko)

Lingviko

The article (der, die, das) of 90,000 German nouns, compounds included, plus a checker that finds wrong articles in German text (“mit der Zug” → dem). Uses dictionary data, not AI guessing. Free, no login.

Advertise