add-watermark
Add watermark to image
LABSCO SUMMARY
The media chores that normally mean looking up FFmpeg flags, reduced to named arguments.
The named operations expose the parameter that actually matters — quality, degrees, opacity, position, effect intensity — and execute-ffmpeg is the release valve for everything they do not cover, which keeps the tool list short without capping what it can do. There is no batch or directory argument anywhere: each call handles one input path, so a folder of assets is a loop on your side.
What it is
A local media toolkit wrapping FFmpeg and ImageMagick, ten tools that each take an inputPath and write to an outputPath.
What you get
- Video converted to another format, compressed at a chosen quality, or trimmed to a duration from a startTime
- Any FFmpeg invocation you can write, handed through execute-ffmpeg as an options string
- PNG compression through ImageMagick with quality as the dial
- Images converted between formats, resized to a width and height with maintainAspectRatio, or rotated by degrees
- A watermark composited onto an image at a position and opacity you set
- A visual effect applied at a chosen intensity
Requirements
No account and no key. FFmpeg for the video tools and ImageMagick for compress-image on the machine running the server, the source files on that same filesystem, and a writable outputPath — every tool is file in, file out.
Setup effort
One command — npx -y mcp-media-processor@latest
USE CASES
01
Cutting a screen recording down to the part worth sharing
Trim from a start time for a set duration, compress what is left at a quality you choose, and convert it to whatever the destination accepts.
02
Getting an image under a page-weight budget
Resize to the dimensions the layout actually uses, compress at a quality you can judge, and convert to the format that serves smallest.
03
Preparing screenshots before they go out
Straighten anything captured at an angle, stamp a watermark at a chosen position and opacity, and apply an effect at an intensity you can dial back.
04
Reaching for an FFmpeg option the named tools do not expose
Pass the full option string yourself with an input path and an output file, for the conversions the nine named operations were never going to cover.
10 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
apply-effect
Apply visual effect to image
compress-image
Compress PNG image using ImageMagick
compress-video
Compress video file
convert-image
Convert image to different format
convert-video
Convert video to different format
execute-ffmpeg
Execute any FFmpeg command with custom options
resize-image
Resize image to specified dimensions
rotate-image
Rotate image by specified degrees
trim-video
Trim video to specified duration
BEFORE YOU INSTALL
What to know first
Tools you get
10 tools when we connected.
Requires
- npx on PATH
- FFmpeg, for the video tools
- ImageMagick, for the image tools
CONTEXT COST
Light Standing cost
Rated by the size of the 10 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mcp-media-processor": {
"command": "npx",
"args": [
"-y",
"mcp-media-processor@latest"
]
}
}
}npx
TERMINAL
npx -y mcp-media-processor@latest
